简介
这个模板会根据指定的日期和时区，换算出新时区下的日期，并按指定的格式输出wiki文本。
虽然没有硬性规定，但是建议在使用这个模板的页面的序章中添加{{TimeZone}}。
参数
- 使用格式：
{{TimeZone/convert
| year = <!-- 年 -->
| mon = <!-- 月 -->
| day = <!-- 日 -->
| hour = <!-- 时 -->
| min = <!-- 分 -->
| sec = <!-- 秒 -->
|o_timezone = <!-- 原来的时区 -->
|c_timezone = <!-- 现在的时区 -->
|<!-- 格式化字符串 -->
}}
{{TimeZone/convert
| y = <!-- 年 -->
| m = <!-- 月 -->
| d = <!-- 日 -->
| h = <!-- 时 -->
| i = <!-- 分 -->
| s = <!-- 秒 -->
|o_tz = <!-- 原来的时区 -->
|c_tz = <!-- 现在的时区 -->
|<!-- 格式化字符串 -->
}}
year、y：原时区下的年份，默认值为在原时区下当前时间的年份。mon、m：原时区下的月份，默认值为在原时区下当前时间的月份。day、d：原时区下的日期，默认值为在原时区下当前时间的日期。hour、h：原时区下的小时数，默认值为在原时区下当前时间的小时数。min、i：原时区下的分钟数，默认值为在原时区下当前时间的分钟数。sec、s：原时区下的秒数，默认值为在原时区下当前时间的秒数。o_timezone、o_tz：原来的时区，默认值为用户当前所在的时区。c_timezone、c_tz：现在的时区，默认值为用户当前所在的时区。{{{1}}}：第一个匿名参数，指示如何格式化新日期。
原理
了解模板的实现原理有助于对模板的理解和运用。 以下说明了模板的实现以及工作原理：
- 在条目序言中添加{{TimeZone}}，将会定义一个全局变量
{{#var:timezone}}。{{#var:timezone}}的值为使用{{TimeZone}}时指定的时间参数，若并未指定时间参数，则使用[[模块:TimeZone]]计算得到的用户当前时区。
- 计算原来的时区和现在的时区
- 计算
o_timezone、o_tz：- 若两个参数的值均为空，则使用[[模块:TimeZone]]计算得到的用户当前时区。
- 计算
c_timezone、c_tz：- 若两个参数的值均为空，则使用
{{#var:timezone}}的值； - 若
{{#var:timezone}}的值为空（【不建议】当未添加{{TimeZone}}的情况下），则使用[[模块:TimeZone]]计算得到的用户当前时区。
- 若两个参数的值均为空，则使用
- 计算
- 依次计算：
year、y：若两个参数的值均为空，则使用在原时区下当前时间的年份。mon、m：若两个参数的值均为空，则使用在原时区下当前时间的月份。day、d：若两个参数的值均为空，则使用在原时区下当前时间的日期。hour、h：若两个参数的值均为空，则使用在原时区下当前时间的小时数。min、i：若两个参数的值均为空，则使用在原时区下当前时间的分钟数。sec、s：若两个参数的值均为空，则使用在原时区下当前时间的秒数。
- 汇总所有参数，使用[[模块:TimeZone]]计算新日期，并根据
{{{1}}}格式化新日期。- 所有格式化参数详见#格式化参数章节
- 返回结果。
格式化参数
package.lua第80行Lua错误：module 'Module:Var-array' not found 目前{{TimeZone/convert}}共支持Template:Array个格式化参数：
示例时间：{{#vardefine:timezone.o_timezone|+08:00}}{{#vardefine:timezone.c_timezone|Module:TimeZone第381行Lua错误：时区参数格式不正确。}}{{#vardefine:timezone.o_timezone.reverse|+{#var:timezone.o_timezone}}}}Module:TimeZone第381行Lua错误：时区参数格式不正确。
| 格式化参数 | 说明 | 示例输出
{{#loop:index|1|Template:Array| |
|---|---|---|
| Template:Array | Template:Array | +08:00}}{{#vardefine:timezone.c_timezone|Module:TimeZone第381行Lua错误：时区参数格式不正确。}}{{#vardefine:timezone.o_timezone.reverse|+{#var:timezone.o_timezone}}}}Module:TimeZone第381行Lua错误：时区参数格式不正确。
}} |
用法
- 简单示例：
{{TimeZone|+8}}
现在是北京时间{{TimeZone/convert|%(yyyy)年%(MM)月%(dd)日 %(HH)时%(mm)分%(ss)秒}}。<br/>
当北京时间{{TimeZone/convert|y=2018|m=12|d=15|h=0|i=0|s=0|%(yyyy)年%(MM)月%(dd)日 %(HH)时%(mm)分%(ss)秒(UTC+8)}}时，太平洋时间为{{TimeZone/convert|Y=2018|m=12|d=15|H=0|i=0|s=0|%(yyyy)年%(MM)月%(dd)日 %(HH)时%(mm)分%(ss)秒(UTC-8)|c_tz=-8}}
除非特别注明，本页面所有时间皆以东八区时间（UTC+08:00）为准。
现在是北京时间{{#vardefine:timezone.o_timezone|+08:00}}{{#vardefine:timezone.c_timezone|Module:TimeZone第381行Lua错误：时区参数格式不正确。}}{{#vardefine:timezone.o_timezone.reverse|+{#var:timezone.o_timezone}}}}Module:TimeZone第381行Lua错误：时区参数格式不正确。。
- 全球各时区时间：
- 主页面：Template:TimeZone/convert/doc/全球各时区时间
高级用法
这个模板与{{TimeZone}}配合使用可以自动转换页面上的所有非特别注明的时间。
案例
- [[少女歌剧 Revue Starlight/1st STAR LIVE -Starry Sky-]]
- [[少女歌剧 Revue Starlight/2nd STAR LIVE -Starry Desert-]]
| ||||||||||||||||||||||