ai.date

支援的時區

支援的日期格式字串權杖

年月日權杖

輸入	範例	說明
YYYY	2014	4 或 2 位數的年份
YY	14	2 位數的年份
Q	1..4	一年的季度。將月份設為季度的第一個月。
M MM	1..12	月份
MMM MMMM	Jan..December	使用地區設定的月份名稱
D DD	1..31	幾號
允許	1 日...31 日	月中的第幾天 - 序號
DDD DDDD	1..365	一年中的第幾天
X	1410715640.579	Unix 時間戳記
x	1410715640579	Unix 毫秒時間戳記

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 小時制
hhh	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