Saltar al contenido principal
Adaptive Planning
Última actualización: 2023-06-23
ai.date

ai.date

El espacio de nombres ai.date permite a los usuarios crear cadenas de fecha y hora ISO8601, así como convertirlas en diferentes husos horarios. Obtenga más información sobre ISO8601 aquí.
Método
Parámetros
Tipo de valor devuelto
Descripción
create( date, sourceTz, format )
  • date : Cadena Base de cadena de fecha
  • sourceTz : String Huso horario para crear fecha en
  • format : String Opcional - Cadena de formato para facilitar el análisis de la fecha
Cadena
Crea una cadena de fecha y hora con formato ISO8601 que incluye la compensación de fecha, hora y huso horario a partir de una cadena de fecha y hora parcial, un huso horario y una cadena de formato opcional. Los tokens para una cadena de formato válida se pueden encontrar a continuación.
IMPORTANTE:
si la fecha no es una cadena ISO8601 válida, debe proporcionar una cadena de formato para analizar y crear correctamente una cadena de fecha.
convertTimezone( date, targetTz )
  • date : Date/String Fecha para convertir
  • targetTz : String Timezone to convert date to
Cadena
Convierte un objeto de fecha de JavaScript o una cadena de fecha ISO8601 válida de un huso horario a otro. El valor devuelto es una cadena de fecha ISO8601 con formato en el huso horario de destino. Los valores válidos para los husos horarios se pueden encontrar a continuación.
getServerTimezone()
Cadena
Devuelve el huso horario de los servidores de integración. Cualquier nuevo objeto de fecha creado en las secuencias de comandos de usuario se tratará como en el huso horario de los servidores.
getSupportedTimezones()
Array<String>
Devuelve una matriz que contiene todos los husos horarios válidos para su uso en convertTimezone().

Husos horarios admitidos

África/Abiyán
America/Grand_Turk
Asia/Amman
Australia/North
Europe/Vaduz
África/Accra
América/Granada
Asia/Anádyr
Australia/Perth
Europa/Vaticano
África/Addis_Ababa
América/Guadalupe
Asia/Aqtau
Australia/Queensland
Europe/Vienna
África/Argel
América/Guatemala
Asia/Aqtobe
Australia/South
Europa/Vilna
África/Asmara
América/Guayaquil
Asia/Ashgabat
Australia/Sydney
Europa/Volgogrado
África/Asmera
America/Guyana
Asia/Ashkhabad
Australia/Tasmania
Europa/Varsovia
África/Bamako
América/Halifax
Asia/Bagdad
Australia/Victoria
Europe/Zagreb
África/Bangui
América/La Habana
Asia/Baréin
Australia/West
Europe/Zaporozhye
África/Banjul
America/Hermosillo
Asia/Baku
Australia/Yancowinna
Europa/Zúrich
África/Bisáu
América/Indiana/Indianápolis
Asia/Bangkok
Brasil/Acre
GB
África/Blantyre
América/Indiana/Knox
Asia/Beirut
Brazil/DeNoronha
GB-Eire
África/Brazzaville
América/Indiana/Marengo
Asia/Bishkek
Brasil/Este
GMT
África/Bujumbura
Estados Unidos/Indiana/Petersburgo
Asia/Brunei
Brasil/Oeste
GMT+0
África/El Cairo
America/Indiana/Tell_City
Asia/Calcutta
CET
GMT-0
África/Casablanca
América/Indiana/Vevay
Asia/Chita
CST6CDT
GMT0
África/Ceuta
América/Indiana/Vincennes
Asia/Choibalsan
Canadá/Atlántico
Greenwich
África/Conakry
América/Indiana/Winamac
Asia/Chongqing
Canada/Central
HST
África/Dakar
América/Indianápolis
Asia/Chungking
Canadá/Saskatchewan Oriental
Hongkong
África/Dar_es_Salaam
América/Inuvik
Asia/Colombo
Canadá/Este
Islandia
África/Yibuti
América/Iqaluit
Asia/Dacca
Canadá/Montaña
Indian/Antananarivo
África/Douala
América/Jamaica
Asia/Damascus
Canadá/Terranova
Indio/Chagos
África/El_Aaiun
América/Jujuy
Asia/Dhaka
Canadá/Pacífico
India/Navidad
África/Freetown
América/Juneau
Asia/Dili
Canadá/Saskatchewan
India/Cocos
África/Gaborone
America/Kentucky/Louisville
Asia/Dubai
Canada/Yukon
India/Comoras
África/Harare
America/Kentucky/Monticello
Asia/Dushanbe
Chile/Continental
India/Kerguelen
África/Johannesburgo
America/Knox_IN
Asia/Gaza
Chile/Isla de Pascua
India/Mahe
África/Juba
America/Kralendijk
Asia/Harbin
Cuba
India/Maldivas
África/Kampala
America/La_Paz
Asia/Hebron
EET
India/Mauricio
África/Jartum
América/Lima
Asia/Ho_Chi_Minh
EST
Indio/Mayotte
África/Kigali
América/Los_Ángeles
Asia/Hong_Kong
EST5EDT
India/Reunión
África/Kinshasa
Estados Unidos/Louisville
Asia/Hovd
Egipto
Irán
África/Lagos
America/Lower_Princes
Asia/Irkutsk
Irlanda
Israel
África/Libreville
América/Maceió
Asia/Istanbul
Etc/GMT
Jamaica
África/Lomé
América/Managua
Asia/Jakarta
Etc/GMT+0
Japón
África/Luanda
América/Manaos
Asia/Jayapura
Etc/GMT+1
Kwajalein
África/Lubumbashi
América/Marigot
Asia/Jerusalem
Etc/GMT+10
Libya
África/Lusaka
América/Martinica
Asia/Kabul
Etc/GMT+11
CUMPLIDO
África/Malabo
América/Matamoros
Asia/Kamchatka
Etc/GMT+12
MST
África/Maputo
América/Mazatlán
Asia/Karachi
Etc/GMT+2
MST7MDT
África/Maseru
America/Mendoza
Asia/Kashgar
Etc/GMT+3
Mexico/BajaNorte
África/Mbabane
América/Menominado
Asia/Kathmandu
Etc/GMT+4
Mexico/BajaSur
África/Mogadiscio
América/Mérida
Asia/Katmandu
Etc/GMT+5
México/General
África/Monrovia
America/Metlakatla
Asia/Khandyga
Etc/GMT+6
NZ
África/Nairobi
America/Mexico_City
Asia/Kolkata
Etc/GMT+7
NZ-CHAT
África/Ndjamena
América/Miquelón
Asia/Krasnoyarsk
Etc/GMT+8
Navajo
África/Niamey
América/Moncton
Asia/Kuala_Lumpur
Etc/GMT+9
PRC
África/Nuakchot
América/Monterrey
Asia/Kuching
Etc/GMT-0
PST8PDT
África/Uagadugú
América/Montevideo
Asia/Kuwait
Etc/GMT-1
Pacífico/Apia
África/Porto-Novo
América/Montreal
Asia/Macao
Etc/GMT-10
Pacífico/Auckland
África/Sao_Tome
América/Montserrat
Asia/Macau
Etc/GMT-11
Pacífico/Bougainville
África/Tombuctú
America/Nassau
Asia/Magadan
Etc/GMT-12
Pacífico/Chatham
África/Trípoli
America/New_York
Asia/Makassar
Etc/GMT-13
Pacífico/Chuuk
África/Túnez
America/Nipigon
Asia/Manila
Etc/GMT-14
Pacífico/Pascua
África/Windhoek
América/Nombre
Asia/Mascate
Etc/GMT-2
Pacífico/Efate
América/Adak
América/Noronha
Asia/Nicosia
Etc/GMT-3
Pacífico/Enderbury
América/Anchorage
America/North_Dakota/Beulah
Asia/Novokuznetsk
Etc/GMT-4
Pacific/Fakaofo
America/Anguilla
America/North_Dakota/Center
Asia/Novosibirsk
Etc/GMT-5
Pacific/Fiji
América/Antigua
America/North_Dakota/New_Salem
Asia/Omsk
Etc/GMT-6
Pacífico/Funafuti
América/Araguaina
América/Ojinaga
Asia/Oral
Etc/GMT-7
Pacific/Galapagos
America/Argentina/Buenos_Aires
América/Panamá
Asia/Phnom_Penh
Etc/GMT-8
Pacífico/Jugador
America/Argentina/Catamarca
America/Pangnirtung
Asia/Pontianak
Etc/GMT-9
Pacífico/Guadalcanal
America/Argentina/ComodRivadavia
América/Paramaribo
Asia/Pyongyang
Etc/GMT0
Pacífico/Guam
America/Argentina/Cordoba
América/Phoenix
Asia/Qatar
Etc./Greenwich
Pacífico/Honolulu
America/Argentina/Jujuy
América/Puerto Príncipe
Asia/Qyzylorda
Etc/UCT
Pacific/Johnston
America/Argentina/La_Rioja
America/Port_of_Spain
Asia/Rangún
Etc/UTC
Pacífico/Kiritimati
America/Argentina/Mendoza
America/Porto_Acre
Asia/Riyadh
Etc/Universal
Pacífico/Kosrae
America/Argentina/Rio_Gallegos
America/Porto_Velho
Asia/Saigón
Etc./Zulú
Pacífico/Kwajalein
America/Argentina/Salta
America/Puerto_Rico
Asia/Sakhalin
Europa/Ámsterdam
Pacífico/Majuro
America/Argentina/San_Juan
America/Rainy_River
Asia/Samarcanda
Europe/Andorra
Pacific/Marquesas
America/Argentina/San_Luis
America/Rankin_Inlet
Asia/Seúl
Europa/Atenas
Pacífico/Midway
América/Argentina/Tucumán
América/Recife
Asia/Shanghai
Europa/Belfast
Pacífico/Nauru
América/Argentina/Ushuaia
América/Regina
Asia/Singapur
Europa/Belgrado
Pacífico/Niue
América/Aruba
América/Resolute
Asia/Srednekolymsk
Europa/Berlín
Pacífico/Norfolk
América/Asunción
America/Rio_Branco
Asia/Taipei
Europa/Bratislava
Pacífico/Numea
América/Atikokan
América/Rosario
Asia/Tashkent
Europa/Bruselas
Pacific/Pago_Pago
America/Atka
America/Santa_Isabel
Asia/Tbilisi
Europa/Bucarest
Pacific/Palau
América/Bahia
América/Santarem
Asia/Teherán
Europa/Budapest
Pacífico/Pitcairn
America/Bahia_Banderas
América/Santiago
Asia/Tel_Aviv
Europa/Busingen
Pacific/Pohnpei
América/Barbados
America/Santo_Domingo
Asia/Thimbu
Europa/Chisináu
Pacífico/Ponapé
América/Belem
America/Sao_Paulo
Asia/Thimphu
Europa/Copenhague
Pacific/Port_Moresby
América/Belice
America/Scoresbysund
Asia/Tokyo
Europa/Dublín
Pacífico/Rarotonga
America/Blanc-Sablon
América/Shiprock
Asia/Ujung_Pandang
Europa/Gibraltar
Pacífico/Saipán
America/Boa_Vista
America/Sitka
Asia/Ulán Bator
Europe/Guernsey
Pacífico/Samoa
América/Bogotá
América/St_Barthelemy
Asia/Ulan_Bator
Europe/Helsinki
Pacífico/Tahití
América/Boise
America/St_Johns
Asia/Urumqi
Europe/Isle_of_Man
Pacífico/Tarawa
América/Buenos_Aires
America/St_Kitts
Asia/Ust-Nera
Europa/Estambul
Pacific/Tongatapu
America/Cambridge_Bay
America/St_Lucia
Asia/Vientián
Europe/Jersey
Pacífico/camión
America/Campo_Grande
America/St_Thomas
Asia/Vladivostok
Europa/Kaliningrado
Pacífico/Wake
América/Cancún
America/St_Vincent
Asia/Yakutsk
Europa/Kiev
Pacífico/Wallis
América/Caracas
América/Swift_Current
Asia/Yekaterinburg
Europa/Lisboa
Pacífico/Yap
América/Catamarca
America/Tegucigalpa
Asia/Ereván
Europe/Ljubljana
Polonia
América/Cayena
América/Thule
Atlántico/Azores
Europa/Londres
Portugal
América/Caimán
America/Thunder_Bay
Atlántico/Bermudas
Europa/Luxemburgo
ROC
América/Chicago
America/Tijuana
Atlántico/Canarias
Europe/Madrid
ROK
América/Chihuahua
América/Toronto
Atlantic/Cape_Verde
Europe/Malta
Singapur
America/Coral_Harbour
América/Tórtola
Atlántico/Feroe
Europa/Mariehamn
Turquía
America/Cordoba
América/Vancouver
Atlántico/Feroe
Europa/Minsk
UCT
America/Costa_Rica
América/Vírgenes
Atlantic/Jan_Mayen
Europa/Mónaco
US/Alaska
America/Creston
América/Whitehorse
Atlantic/Madeira
Europa/Moscú
EE. UU./Aleutianas
America/Cuiaba
América/Winnipeg
Atlantic/Reykjavik
Europa/Nicosia
US/Arizona
América/Curazao
America/Yakutat
Atlantic/South_Georgia
Europa/Oslo
US/Central
América/Dinamarcashavn
América/Yellowknife
Atlantic/St_Helena
Europa/París
EE. UU./Este de Indiana
América/Dawson
Antártida/Casey
Atlántico/Stanley
Europe/Podgorica
EE. UU./Este
America/Dawson_Creek
Antártida/Davis
Australia/ACT
Europa/Praga
EE. UU./Hawái
América/Denver
Antarctica/DumontDUrville
Australia/Adelaide
Europa/Riga
EE. UU./Indiana-Starke
América/Detroit
Antártida/Macquarie
Australia/Brisbane
Europa/Roma
US/Michigan
América/Dominica
Antártida/Mawson
Australia/Broken_Hill
Europe/Samara
EE. UU./Montaña
América/Edmonton
Antártida/McMurdo
Australia/Canberra
Europe/San_Marino
EE. UU./Pacífico
América/Eirunepe
Antártida/Palmer
Australia/Currie
Europe/Sarajevo
EE. UU./Pacífico - Nuevo
America/El_Salvador
Antártida/Rothera
Australia/Darwin
Europe/Simferopol
US/Samoa
América/Ensenada
Antártida/Polo_Sur
Australia/Eucla
Europa/Skopie
UTC
America/Fort_Nelson
Antártida/Syowa
Australia/Hobart
Europa/Sofía
Universal
America/Fort_Wayne
Antártida/Troll
Australia/LHI
Europa/Estocolmo
W-SU
America/Fortaleza
Antártida/Vostok
Australia/Lindeman
Europa/Tallin
HÚMEDO
America/Glace_Bay
Ártico/Longyearbyen
Australia/Lord_Howe
Europa/Tirana
Zulu
América/Godthab
Asia/Aden
Australia/Melbourne
Europa/Tiraspol
America/Goose_Bay
Asia/Almaty
Australia/NSW
Europa/Uzhgorod

Tokens de cadena de formato de fecha admitidos

El analizador ignora los caracteres no alfanuméricos.
Fichas de año, mes y día
Entrada
Ejemplo
Descripción
YYYY
2014
Año de 4 o 2 dígitos
YY
14
Año de 2 dígitos
Q
1..4
Trimestre de año Establece mes como el primer mes del trimestre.
M MM
1..12
Número de mes
MMM MMMM
Ene..Diciembre
Nombre de mes en configuración regional
D DD
1..31
Día del mes
Permitido
Del 1 al 31
Día del mes con ordinal
DDD DDDD
1..365
Día del año
X
1410715640,579
Marca de tiempo de Unix
x
1410715640579
Marca de tiempo de ms de Unix
YYYY de la versión 2.10.5 admite años de 2 dígitos y los convierte a un año cercano a 2000 (igual que YY).
Fichas de año de semana, semana y día de semana
En estos casos, los tokens en minúsculas utilizan los días de inicio de semana que tienen en cuenta la configuración regional, y los tokens en mayúsculas utilizan los días de inicio de fecha de semana ISO .
Entrada
Ejemplo
Descripción
gggg
2014
Año de semana de 4 dígitos de configuración regional
gg
14
Año de semana de 2 dígitos de configuración regional
w ww
1..53
Semana del año de configuración regional
e
1..7
Día de la semana de configuración regional
ddd dddd
Lun...Domingo
Nombre de día en configuración regional
GGGG
2014
Año de semana ISO de 4 dígitos
GG
14
Año de semana ISO de 2 dígitos
W WW
1..53
Semana ISO del año
E
1..7
Día de la semana según ISO
Tokens de hora, minuto, segundo, milisegundo y compensación
Entrada
Ejemplo
Descripción
H HH
0..23
Horario de 24 horas
h hh
1..12
12 horas utilizadas con una A.
a A
a. m. p. m.
Posterior al meridiano o ante
m mm
0..59
Minutos
s ss
0..59
Segundos
S SS SSS
0..999
Fracciones de segundo
Z ZZ
+12:00
Desplazamiento respecto a UTC como +-HH:mm, +-HHmm o Z

Creación de cadenas de fecha y 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"

Conversión de cadenas de fecha y 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"

Obtención de huso horario de servidor

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

Obtención de todos los husos horarios admitidos

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