查看“Help:时间序号”的源代码

'''時間序號'''是[[Help:解析器函数|模板擴展語法]]中，<nowiki>{{#time:}}</nowiki>的一種。時間序號的編碼是<nowiki>{{#time:U}}</nowiki>。而現在時間（{{#time:Y年n月j日 h:i:s a}}）的時間序號為{{#time:U}}。

== 介紹 ==
時間序號主要用作模板倒數。而時間序號是由1970年1月1日00:00:00起的秒數，而1970年1月1日00:00:00的時間序號就是1，1970年1月1日00:00:01的時間序號就是2，如此類推。

=== 好處 ===
使用時間序號作出模板倒數，較其它編碼較好。主要原因是每月的日數都不同，而每4年的天數也不同。而時間序號便會免除這些日子差異。但使用時間序號，需要懂得如何計算。

== 計算方法 ==
以下是各種時間單位的秒數。

{| class="wikitable"
|-
! 時間(1) !! 相等於秒數
|-
| 秒 || 1
|-
| 分鐘 || 60
|-
| 小時 || 3600
|-
| 天 || 86400
|-
| 年 || 31536000
|-
| 閏年 || 31622400
|-
|}

即表示，每過一秒，時間序號便會加1；每過一分鐘，時間序號便會加60；每過一天，時間序號便會加86400，如此類推。

=== 各年份的時間序號 ===
以下時2000年至2020年，每年1月1日00:00:00的時間序號。
{| class="wikitable" style="text-align:right"
|-
! 年份 !! 1月1日00:00:00<br>時間序號
|-
| 2000 || {{#time:U|2000-1-1 00:00:00}}
|-
| 2001 || {{#time:U|2001-1-1 00:00:00}}
|-
| 2002 || {{#time:U|2002-1-1 00:00:00}}
|-
| 2003 || {{#time:U|2003-1-1 00:00:00}}
|-
| 2004 || {{#time:U|2004-1-1 00:00:00}}
|-
| 2005 || {{#time:U|2005-1-1 00:00:00}}
|-
| 2006 || {{#time:U|2006-1-1 00:00:00}}
|-
| 2007 || {{#time:U|2007-1-1 00:00:00}}
|-
| 2008 || {{#time:U|2008-1-1 00:00:00}}
|-
| 2009 || {{#time:U|2009-1-1 00:00:00}}
|-
| 2010 || {{#time:U|2010-1-1 00:00:00}}
|-
| 2011 || {{#time:U|2011-1-1 00:00:00}}
|-
| 2012 || {{#time:U|2012-1-1 00:00:00}}
|-
| 2013 || {{#time:U|2013-1-1 00:00:00}}
|-
| 2014 || {{#time:U|2014-1-1 00:00:00}}
|-
| 2015 || {{#time:U|2015-1-1 00:00:00}}
|-
| 2016 || {{#time:U|2016-1-1 00:00:00}}
|-
| 2017 || {{#time:U|2017-1-1 00:00:00}}
|-
| 2018 || {{#time:U|2018-1-1 00:00:00}}
|-
| 2019 || {{#time:U|2019-1-1 00:00:00}}
|-
| 2020 || {{#time:U|2020-1-1 00:00:00}}
|-
|}

=== 取得時間序號 ===
==== 電腦計算 ====
取得時間序號，可使用[[Help:解析器函数|模板擴展語法]]。以下為一例子，若要取得2016年5月19日晚上7時21分52秒的時間序號，可寫以下語法：
<pre>
{{#time:U|2016-5-19 07:21:52}} 
</pre>
便得：{{#time:U|2016-5-19 07:21:52}}
或要直接得到時間序號，可使用"subst:"，如下：
<pre>
{{subst:#time:U|2016-5-19 07:21:52}} 
</pre>
便得：1463642512

==== 人手計算 ====
不使用語法，亦可直接人手計算。假如要取得2009年1月21日21:54:42的時間序號，可根據上面的2009年1月1日00:00:00的時間序號計算。先把1230768000加上20天（別忘記不是21天，因為並非由1月0日開始計算），即86400 x 20，便得1232496000。然後，再加上21小時，即3600 x 21，便得1232571600。然後，再加上54分鐘，即60 x 54，便得1232574840。最後，再加上42秒，即1232574882。最終，便能得到2009年1月21日21:54:42的時間序號是1232574882。

== 應用例子 ==
假如要製作2016年3月13日21時30分正的'''日數'''及'''小時'''的倒數模板。首先，計算得出當天的時間序號：（為了方便大家明白，這個例子不使用模板，而直接使用該時間序號的數字）
<pre>
{{subst:#time:U|2016-3-13 21:30:00}}
</pre>
並得：1457904600
=== 日數 ===
然後，把1457904600減去現在的時間序號：
{| class="wikitable" width=100% style="background:#F0F0F0;border:#3C78B5"
|-
|<nowiki>{{#expr: 1457904600 - {{#time:U}} }}天
</nowiki>
|-
|}

並顯示為"{{#expr: 1457904600 - {{#time:U}} }}天"。但由於出現的都只是秒數，所以，可把該數目除去一天的秒數，即86400，並得：
{| class="wikitable" width=100% style="background:#F0F0F0;border:#3C78B5"
|-
|<nowiki>
{{#expr: ( 1457904600 - {{#time:U}}) / 86400 }}天
</nowiki>
|-
|}

並顯示為"{{#expr: ( 1457904600 - {{#time:U}}) / 86400 }}天"。但可能會出現不能除盡的情況，因此，可以使用舍入法。但由於舍入法只提供四舍五入的方法，即假如0.87天，將會舍入至1日。因此，可以把數目減去0.5，並得：
{| class="wikitable" width=100% style="background:#F0F0F0;border:#3C78B5"
|-
|<nowiki>
{{#expr: ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0}}天
</nowiki>
|-
|}

並顯示為"{{#expr: ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0}}天"。但由於-0.5至0的數目會舍入至-0，此項將於最後說明解決方法。

=== 時數 ===
同樣地，把1457904600減去現在的時間序號，並把該數目除去一小時的秒數，並得：
{| class="wikitable" width=100% style="background:#F0F0F0;border:#3C78B5"
|-
|<nowiki>
{{#expr: ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0}}天{{#expr: ( 1457904600 - {{#time:U}} ) / 3600 }}小時
</nowiki>
|-
|}

並顯示為"{{#expr: ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0}}天{{#expr: ( 1457904600 - {{#time:U}} ) / 3600 }}小時"。但由於得出的小時數目，未減去已計算的天數。因為，需要先減去天數。並得：
{| class="wikitable" width=100% style="background:#F0F0F0;border:#3C78B5"
|-
|<nowiki>{{#expr: ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0}}天{{#expr: (1457904600 - {{#time:U}}) / 3600 - ( ( ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0 ) * 24 ) }}小時
</nowiki>
|-
|}

並顯示為"{{#expr: ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0}}天{{#expr: (1457904600 - {{#time:U}}) / 3600 - ( ( ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0 ) * 24 ) }}小時"。但同樣地，可能會出現不能除盡的法況，因此需要運用舍入法，並同樣地減去0.5。並得：
{| class="wikitable" width=100% style="background:#F0F0F0;border:#3C78B5"
|-
|<nowiki>{{#expr: ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0}}天{{#expr: ( ( (1457904600 - {{#time:U}}) / 3600 - ( ( ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0 ) * 24 ) ) -0.5 ) round 0}}小時
</nowiki>
|-
|}

並顯示為"{{#expr: ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0}}天{{#expr: ( ( (1457904600 - {{#time:U}}) / 3600 - ( ( ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0 ) * 24 ) ) -0.5 ) round 0}}小時"。

=== 最後步驟 ===
倒數器的日子始終都會到達。其後，便會出現負數。假如不想出現負數，可使用另一個模板語法<nowiki>{{#ifeq:}}</nowiki>。別忘記先前天數曾經減去0.5，因為，0.5天的時間序號是43200。並可得出：
{| class="wikitable" width=100% style="background:#F0F0F0;border:#3C78B5"
|-
|<nowiki>{{#ifeq: {{#expr:{{#time:U}} <= (1457904600 - 43200)}} | 1 | 距離2016年3月12日21時30分尚餘{{#expr: ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0}}天{{#expr: ( ( (1457904600 - {{#time:U}}) / 3600 - ( ( ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0 ) * 24 ) ) -0.5 ) round 0}}小時 | 2016年3月12日21時30分已過去}}
</nowiki>
|-
|}

並顯示為"{{#ifeq: {{#expr:{{#time:U}} <= (1457904600 - 43200)}} | 1 | 距離2016年3月12日21時30分尚餘{{#expr: ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0}}天{{#expr: ( ( (1457904600 - {{#time:U}}) / 3600 - ( ( ( ( 1457904600 - {{#time:U}}) / 86400 - 0.5 ) round 0 ) * 24 ) ) -0.5 ) round 0}}小時|2016年3月13日21時30分已過去}}"。

== 應用模板 ==
模板{{tl|countdown}}是應用了時間序號來製作的倒數模板。與上面的製作方法差不多，但較複雜。

{{-}}
{{帮助页面}}