ai.date

支持的时区

支持的日期格式字符串标记

年、月、日令牌

输入	示例	描述
YYYY	2014	4 位数或 2 位数年份
YY	14	2 位数年份
Q	1..4	一年中的季度将月设置为季度的第一个月。
M MM	1..12	月份编号
MMM MMMM	1 月..12 月	月份名称（区域设置）
D DD	1..31	每月的某一天
支持	1 日..31 日	一个月中的某一天（包含序号）
滴滴滴滴	1..365	一年中的哪一天
X	1410715640.579	Unicode 时间戳
x	1410715640579	Unicode 毫秒时间戳

从版本 2.10.5 开始，YYYY 支持 2 位数年份，并将其转换为接近 2000 的年份（与 YY 相同）。

周 - 年、周和工作日令牌

对于这些日期，小写标记使用可识别区域设置的周开始天数，而大写标记使用 ISO 周 日期开始天数。

输入	示例	描述
gggg	2014	区域设置 - 4 位数的周 - 年
gg	14	区域设置 - 2 位数的周 - 年
WW	1..53	区域设置：一年中的第几周
e	1..7	区域设置：星期几
ddd dddd	星期一...星期日	日期名称（区域设置）
GGGG	2014	ISO 4 位数周年
GG	14	ISO 2 位数周年
W WW	1..53	ISO 一年中的第几周
E	1..7	ISO 星期几

时、分、秒、毫秒和偏移量令牌

输入	示例	描述
H HH	0..23	24 小时制
小时 hh	1..12	用于 A 的 12 小时时间。
a A	上午	中午前后
m mm	0..59	分钟
s ss	0..59	秒
S SS SSS	0..999	秒的小数部分
Z ZZ	+12:00	与 UTC 的偏移量（格式为 +-HH:mm、+-HHmm 或 Z）

创建 ISO8601 日期时间字符串

// create a date from a date fragment that is in ISO8601 format
var date = ai.date.create('2016-02-01', 'America/Los_Angeles');
// date is "2016-02-01T00:00:00-08:00"
 
// create a date from a date fragment that is NOT in ISO8601 format
var date = ai.date.create('02/01/2016', 'America/Los_Angeles', 'MM/DD/YYYY');
// date is "2016-02-01T00:00:00-08:00"
 
// create a date from a date fragment that is NOT in ISO8601 format, but in Australian format
var date = ai.date.create('02/01/2016', 'America/Los_Angeles', 'DD/MM/YYYY');
// date is "2016-01-02T00:00:00-08:00"
 
// create a date from a date and time fragment, but no offset, fragment is in ISO8601 format.
var date = ai.date.create('2016-02-01T05:00', 'America/Los_Angeles');
// date is "2016-02-01T05:00:00-08:00"
 
var date = ai.date.create('2016-02-01 05:00', 'America/Los_Angeles');
// date is "2016-02-01T05:00:00-08:00"
 
// create a date that includes daylight savings
var date = ai.date.create('2016-02-01 12:00', 'Australia/Sydney');
// date is "2016-02-01T12:00:00+11:00"
 
// without daylight savings...
var date = ai.date.create('2016-06-01 12:00', 'Australia/Sydney');
// date is "2016-02-01T12:00:00+10:00"
 
// create a date in UTC
var date = ai.date.create('2016-03-01', 'UTC');
// date is "2016-03-01T00:00:00+00:00"

转换 ISO8601 日期时间字符串

// convert Brisbane to Sydney time with daylight savings
var date = ai.date.convertTimezone(new Date('2015-01-15T12:00:00+10:00'), 'Australia/Sydney');
// date is "2015-01-15T13:00:00+11:00"
 
// convert Brisbane to Sydney time without daylight savings
var date = ai.date.convertTimezone('2015-06-15T12:00:00+10:00', 'Australia/Sydney');
// date is "2015-06-15T12:00:00+10:00"
 
// convert Brisbane to New York time
var date = ai.date.convertTimezone('2015-06-15T12:00:00+10:00', 'America/New_York');
// date is "2015-06-14T22:00:00-04:00"
 
// convert New York to Brisbane time
var date = ai.date.convertTimezone('2015-06-15T12:00:00-04:00', 'Australia/Brisbane');
// date is "2015-06-16T02:00:00+10:00"
 
// convert New York to UTC time
var date = ai.date.convertTimezone('2015-06-15T12:00:00-04:00', 'UTC');  
// date is "2015-06-15T16:00:00+00:00"

获取服务器时区

var serverTz = ai.date.getServerTimezone();
// as an example, serverTz = 'America/Los_Angeles'

获取所有支持的时区

var timezones = ai.date.getSupportedTimezones();
// timezones is an array containing the above 583 timezones