模板:Timeconv/doc
一个时间转换模板。
注意事项
- 这个模板以UTC作为基础时区。
- 这个模板不自动处理夏令时计算。
- 这个模板不适用于UTC偏移量非整数小时的时区。
- 如需进一步了解这个模板中涉及的时间格式，请查阅中文维基百科中的相关信息。
基本用法和参数
{{timeconv|原始时间|调整小时数}}
原始时间
符合格式要求的时间数值。通常可使用类似2018-05-26 13:59的格式。
除常见格式外，原始时间也可使用Unix时间戳。使用时应以@开始。
原始时间的缺省值是用户查看页面时的UTC时间。
调整小时数
可选参数，用于设置转换前后的时间差。例如从北京时间转换为日本标准时间即为+1，从北京时间转换为日本标准时间即为-8。
使用这个参数时，必须同时使用原始时间参数，而且不应将这个参数放置在原始时间参数之前。如果需要将原始时间设置为用户查看页面时的UTC时间，可将now作为原始时间参数，或在本参数前添加t=参数名。
其他可选参数
使用这些参数时不能省略参数名。
|format=转换后的时间格式
|f=原始时间所属时区
|t=转换的目标时区
关于时区参数的说明
在使用|f=
、|t=
参数时，可直接使用时区的UTC偏移量，例如北京时间为+8，日本标准时间为+9。
此外，模板还预设了一些常用的时区名称或非正式称谓，例如|f=北京时间
等效于|f=+8
。
| 时区名称或非正式称谓 | UTC偏移量 |
|---|---|
| 日本标准时间、东京时间、日服、JST、JP | +9 |
| 北京时间、国服、BT、CN | +8 |
| 协调世界时、UTC | ±0 |
| 太平洋夏令时间、PDT | -7 |
| 太平洋标准时间、PST | -8 |
范例
当前的北京时间
{{timeconv|now|+8}}
{{timeconv|t=+8}}
{{timeconv|t=BT}}
2024-11-22 03:48
2024-11-22 03:48
2024-11-22 03:48
从日本标准时间转换至北京时间
{{timeconv|201806251800|-1}}
{{timeconv|2018-6-25 18:00|f=+9|t=+8}}
{{timeconv|20180625 18:00|f=JST|t=BT}}
{{timeconv|20180625180000|f=+9|t=北京时间}}
2018-06-25 17:00
2018-06-25 17:00
2018-06-25 17:00
2018-06-25 17:00
将Unix时间戳转换为北京时间
{{timeconv|@1531461599|t=bt}}
{{timeconv|@1531461599|+8}}
2018-07-13 13:59
2018-07-13 13:59
取得北京时间的Unix时间戳
{{timeconv|2018-07-13 13:59:59|format=U|-8}}
{{timeconv|2018-07-13 13:59:59|format=U|f=北京时间}}
1531461599
1531461599