ai.date

Fusos horários com suporte

Tokens de cadeia de caracteres de formato de data com suporte

Tokens de ano, mês e dia

Entrada	Exemplo	Descrição
YYYY	2014	Ano com 4 ou 2 dígitos
YY	14	Ano com 2 dígitos
Q	1..4	Trimestre do ano Define o mês como o primeiro mês do trimestre.
M MM	1..12	Número do mês
MMM MMMM	Janeiro...Dezembro	Nome do mês nos parâmetros regionais
D DD	1..31	Dia do mês
O que fazer	1º...31º	Dia do mês com ordinais
DDD DDDD	1..365	Dia do ano
X	1410715640.579	Data e hora do Unix
x	1410715640579	Data e hora de MS Unix

YYYY da versão 2.10.5 oferece suporte a anos com 2 dígitos e os converte em um ano próximo a 2000 (igual a YY).

Tokens de ano, semana e dia de semana da semana

Para eles, os tokens em minúsculas usam os dias de início da semana que levam em consideração os parâmetros regionais, e os tokens em maiúsculas usam os dias de início da data da semana ISO .

Entrada	Exemplo	Descrição
gggg	2014	Ano da semana de 4 dígitos dos parâmetros regionais
gg	14	Ano da semana de 2 dígitos dos parâmetros regionais
w ww	1..53	Semana do ano nos parâmetros regionais
e	1..7	Dia da semana dos parâmetros regionais
dddd dddd	Seg...Domingo	Nome do dia nos parâmetros regionais
GGGG	2014	ISO - Semana com 4 dígitos - Ano
GG	14	ISO - Semana, ano, com 2 dígitos
W WW	1..53	Semana ISO do ano
E	1..7	Dia ISO da semana

Horas, minutos, segundos, milissegundos e tokens de deslocamento

Entrada	Exemplo	Descrição
H HH	0..23	período de 24 horas
h hh	1..12	12 horas usado com A.
a A	15h	Publicar ou antecipar o vencimento por mérito
m mm	0..59	Minutos
s ss	0..59	Segundos
SSS SSS	0..999	Segundos fracionários
Z ZZ	+12:00	Deslocamento do UTC como +-HH:mm, +-HHmm ou Z

Como criar cadeias de caracteres de data e hora 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"

Conversão de cadeias de caracteres de data e hora 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"

Obtendo fuso horário do servidor

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

Obtenção de todos os fusos horários com suporte

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