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 ) |
| 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 ) |
| 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
- EntradaEjemploDescripciónYYYY2014Año de 4 o 2 dígitosYY14Año de 2 dígitosQ1..4Trimestre de año Establece mes como el primer mes del trimestre.M MM1..12Número de mesMMM MMMMEne..DiciembreNombre de mes en configuración regionalD DD1..31Día del mesPermitidoDel 1 al 31Día del mes con ordinalDDD DDDD1..365Día del añoX1410715640,579Marca de tiempo de Unixx1410715640579Marca de tiempo de ms de UnixYYYY 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 .EntradaEjemploDescripcióngggg2014Año de semana de 4 dígitos de configuración regionalgg14Año de semana de 2 dígitos de configuración regionalw ww1..53Semana del año de configuración regionale1..7Día de la semana de configuración regionalddd ddddLun...DomingoNombre de día en configuración regionalGGGG2014Año de semana ISO de 4 dígitosGG14Año de semana ISO de 2 dígitosW WW1..53Semana ISO del añoE1..7Día de la semana según ISO
- Tokens de hora, minuto, segundo, milisegundo y compensación
- EntradaEjemploDescripciónH HH0..23Horario de 24 horash hh1..1212 horas utilizadas con una A.a Aa. m. p. m.Posterior al meridiano o antem mm0..59Minutoss ss0..59SegundosS SS SSS0..999Fracciones de segundoZ ZZ+12:00Desplazamiento 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