Yaqa mayqin laya ruwana JavaScript kaqpi qillqasqa pachakunawan utaq p'unchawkunawan wakin atiypi llamk'an. Qallariypiqa, kayqa ruwasqa P'unchaw API kaqllapim karqan. Kay API qallariy ruwanakunata churan, ichaqa ancha pisilla ima ruwayta atisqanpi. Kimsa kaq bibliotecakuna Moment.js hina, chaymanta qhipaman ruwasqa APIkuna Intl APIkuna chaymanta musuq Temporal API hina, aswan hatun flexibilidadta yapanku pachakunawan chaymanta p'unchawkunawan llamk'anapaq. El Rice Y Caída De Momento.js Moment.js huk JavaScript biblioteca kallpasapa yanapakuykunawan pachakunawan chaymanta p'unchawkunawan llamk'anapaq. Chayqa chinkasqa ruwanakunata sapsi P'unchaw API kaqmanta yapan, ahinataq pacha kiti manipulación kaqmanta, chaymanta achka común ruwanakuna aswan sasallawan ruwan. Moment nisqapiqa p'unchawkuna, pachakuna formato ruwanapaq ruwanakunapas kachkan. Achka imaymana ruwaykunapi ancha llamk'achisqa bibliotecaman tukurqan. Ichaqa Momentpas karqanmi parten asuntokuna. Hatun biblioteca kaq, chaymanta huk ruwanapa paquete sayayninman anchata yapayta atin. Imaraykuchus biblioteca mana sach’a chhaphchiyta yanapanchu (kunan pacha paquetes kaqpa ruwaynin mayqinchus mana llamk’asqa partes bibliotecas kaqmanta hurquyta atin), tukuy Moment biblioteca huk utaq iskay ruwayninkunallata llamk’achkanki chaypas. Momentwan huk sasachakuyqa, kamasqan imakuna tikray atiymi. Wakin ruwanakunata huk Moment kaqpi waqyayqa efectos secundariosniyuq chaymanta chay objetopa chaninninta tikran. Kayqa mana suyasqa ruwayman utaq pantaykunata apamunman. 2020 watapi, Moment nisqap allichaqninkunam bibliotecata mantenimiento nisqaman churanankupaq tantearurqaku. Mana musuq ruwanakuna wiñachiy ruwasqachu kachkan, chaymanta waqaychaqkuna musuq llamkanakunapaq mana llamk'achiyta yuyaychanku. Huk JavaScript p’unchaw bibliotecakuna kanku, p’unchaw-fns hina, ichaqa llaqtapi musuq pukllaq kan, huk API chiqalla JavaScript kaqpi ruwasqa: Temporal. Musuq kamachiymi mayqinchus ñawpaq P’unchaw API kaqpa t’uqunkunata hunt’achin chaymanta wakin Moment kaqpi chaymanta wak bibliotecakunapi tarisqa limitacionkunata allichan. ¿Imataq Temporal? Temporal huk musuq pacha chaymanta p'unchaw API ECMAScript kamachiyman yapasqa, kunan pacha JavaScript kaqmanta riqsichin. 20266 watapi marzo killamanta, TC39 ruwaymanta 4 kaq Etapaman chayasqa (comité mayqinchus JavaScript simiman propuestakunata chaymanta yapasqakunata qhawan), chaymanta ECMAScript especificación kaqmanta qatiq laya kaqpi churasqa kanqa. Ñam achka maskaqkunapi ruwasqaña: Chrome 144+ chaymanta Firefox 139+, Safari usqhaylla qatinanta suyasqa. Huk polyfill mana yanapasqa maskaqkunapaq chaymanta Node.js kaqpaqpas kanmi. API Temporal kaqninqa imakuna ruwan, mayqinkunachus, tukuypaq, pachakunapi pachakunata rikuchinku. Kaykunaqa tukuy pachapaq chaymanta p'unchaw sellokuna huk qusqa pacha kitipi kanman, utaq huk genérico instancia “perqa reloj” pachamanta kanman mana ima pacha zona utaq p'unchaw willakuyniyuq. Temporal nisqap wakin hatun ruwayninkunaqa kaykunam:
P'unchawkunayuq utaq mana p'unchawniyuq pachakuna.Huk Objeto Temporal nisqa huk p'unchawpi huk pachata, utaq mana p'unchaw willakuyniyuq pachata rikuchiyta atin. Huk p’unchaw específica, mana pachayuq, rikuchikunmantaqmi. Tiempo zona yanapakuy.Temporal objetokuna hunt'asqa pacha zona yachaq kanku chaymanta hukniray pacha zonakunapura tikray atikunku. Moment pacha zonakunata yanapan, chaymanta, ichaqa yapasqa momento-hora zona bibliotecata mañan. Mana tikray atiy.Huk kuti Temporal objeto kamasqa kaptinqa manam tikrayta atikunmanchu. Tiempo yupay icha pacha kiti tikraykunaqa manam ura kaq imayaytaqa tikranchu. Aswanpas musuq Temporal objeto nisqatam paqarichimunku. 1-pi sayasqa indexing.Huk común pukyuta pantaykunata P'unchaw API kaqwan (hinallataq Moment kaqwan) killakuna cero-indexed kasqanku. Kayqa niyta munan, enero killaqa 0 killa, manataq 1 killachu, chiqap kawsaypi llapanchik entiendesqanchikman hina. Temporal kayta allichan 1-pi sayasqa indexación llamk'achispa — enero killa 1 killa. Navegador kaqpi ruwasqa kachkan.Temporal huk API kikin maskaqpi kasqanrayku, mana imatapas yapanchu ruwanaykipa paquete sayayninman.
Hinallataq, ancha allinmi kayta yachanapaq, P’unchaw API mana chinkachkanchu. Temporal kay APIta rantinpi churachkaptinpas, manam hurqusqachu nitaq manaña llamk'achisqachu. Askha ruwanakuna p'akikunman sichus maskaqkuna qunqayllamanta P'unchaw API kaqmanta hurqunkuman. Ichaqa, yuyaypipas hap'iy Moment kunan huk proyecto herencia hina qhawasqa kasqanmanta modo de mantenimiento kaqpi. Puchuq qillqapi, wakin “recetas” qhawasunchik Moment-pi ruwasqa codigo musuq Temporal API kaqman astaypaq. ¡Refactorización nisqa ruwayta qallarisun! Punchaw Y Pacha Objetokunata Ruway Manaraq fechakunata, horakunata manipulachkaspaqa, chaykunata representaq objetokunatam ruwananchik. Kunan p'unchawta, pachata rikuchiq Moment objeto ruwanapaq, moment llamk'ayta llamk'achiy. const kunan = ratu (); consola.log (kunan); // Rato<2026-02-18T21:26:29-05:00>
Kay imayayqa kunanqa necesitasqanman hinam formatochasqa utaq manipulasqa kanman.
// UTC nisqaman tikray //advertencia: Kayqa Moment objetota tikran chaymanta UTC modoman churan! consola.log (kunan.utc ()); // Ratu<2026-02-19T02:26:29Z>
// huk formatochasqa watiqata imprimiy - kunan UTC pachata llamk'achkan chayta qhaway consola.log (kunan.formato ('MM / DD / YYYY hh: mm: ss a')); // 19/02/2026 02:27:07 pacha
Momentmanta yuyarinapaq llalliq kaqmi, Moment objeto sapa kuti pachamanta, p'unchawmanta willayta churan. Sichus pacha willaywanlla llamk'anayki tiyan, kayqa aswan allin, ichaqa mana suyasqa ruwayta ruwanman kayhina situacionkunapi kayhina P'unchaw pacha utaq bisiesto watakunapi, maypi p'unchawqa pacha yupaykunapi huk efectota ruwayta atin. Temporal nisqa aswan flexible nisqa. Kunan p'unchawta, pachata rikuchiq imayayta ruwayta atinki, Temporal.Instant nisqa imayayta ruwaspa. Kayqa huk pachata riqsichin, “epoca” nisqamanta pacha (kuska tuta UTC 1 ñiqin tarpuy killapi 1970 watapi). Temporal kay instanteta pachapi nanosegundo-nivel precisión kaqwan referenciayta atin. const kunan = Temporal.Kunan.instant ();
// qhaway crudo nanosegundos nisqakunata chay época nisqamantapacha consola.log (kunan.epochNanosegundos); // 1771466342612000000n
// UTC nisqapaq formato consola.log (kunan.mantaString ()); // 2026-02-19T01:55:27.844Z
// huk pacha kitipaq formato console.log (kunan.toString ({ pacha Zona: 'América/Nueva_York' })); // 2026-02-18T20:56:57.905-05:00
Temporal.Instant objetokunatapas huk pachapaq chaymanta p'unchawpaq ruwayta atikunman, from static método kaqwan.
const miInstant = Temporal.Instant.manta ('2026-02-18T21:10:00-05:00');
// Llaqta pacha kitipi chaylla formatochay. Reparay kayqa controlanlla kasqanmanta // chay formato - mana moment.utc hinachu objetota tikran. console.log (myInstant.toString ({ pacha Zona: 'América/Nueva_York' })); // 2026-02-18T21:10:00-05:00
Huk laya Temporal objetokunatapas ruwayta atinki, kayhina:
Temporal.PlainDate: Mana pacha willayniyuq p'unchaw. Temporal.PlainTime: Mana p'unchaw willayniyuq pacha. Temporal.ZonedDateTime: Huk p'unchaw chaymanta pacha huk chiqan pacha kitipi.
Sapanka kaykunamanta huk from métodoyuqmi, p'unchawta chaymanta/utaq pachata willaq imawan waqyayta atikun, icha p'unchaw kaskaq t'aqwinapaq. // Huk p'unchawlla const kunan = Temporal.LlanoPunchaw.manta({ wata: 2026, 2026 watapi. killa: 2, // reparay 2 nisqawan febrero killapaq punchaw: 18 }); console.log (kunan.mantaString ()); // 2026-02-18 watapi
// Huk pachalla const almuerzoTiempo = Temporal.LlanoTiempo.de({ hora: 12 }); console.log (almuerzoTiempo.mantaString ()); // 12:00:00 pacha
// Huk p'unchaw, pacha EE.UU. Chinchay pacha kitipi const dueAt = Temporal.ZonadoP'unchawTiempo.from({ pachaZone: 'América/Nueva_York', . wata: 2026, 2026 watapi. killa: 3, 2019. p'unchaw: 1, 2019. hora: 12, 12. minutu: 0, 10. iskay kaq: 0 }); consola.log (debidoAt.mantaString ()); // 2026-03-01T12:00:00-05:00[América/Nueva_York].
Parsing nisqa P’unchaw chaymanta pacha willayta programamanta ruwayta qhawarqayku. Kunanqa t’aqwiyta qhawarisun. Parsing huk área maypi Moment aswan flexible kan chaymanta ruwasqa Temporal API kaqmanta. P'unchaw kaskaqta t'aqwiyta atinki, ratu llamk'anaman pasaspa. Huklla argumentowan, Moment huk ISO p'unchaw kaskaqta suyan, ichataq huk formatokunata llamk'achiy atikunki sichus iskay ñiqin argumentota qunki p'unchaw formato llamk'achisqa kaqta willaspa.
const isoPunchaw = ratu ('2026-02-21T09:00:00'); const formatadoPunchaw = momento ('2/21/26 9:00:00', 'M / D / YY h: mm: ss');
consola.log (isoP'unchaw); // Rato<2026-02-21T09:00:00-05:00>
console.log (formatadoP'unchaw); // Rato<2026-02-21T09:00:00-05:00>
Ñawpa layakunapi, Moment aswan allin adivinanzata ruwanman mayqin munasqalla formatochasqa p'unchaw kaskaqtapas t'aqwinanpaq. Chayqa mana yachay atina ruwaykunamanmi apawasunman. Ejemplopaq, 02-03-2026 2 febrerochu icha 3 marzochu? Kayrayku, aswan musuq Moment kaqmanta layakuna huk riqsisqa pisichasqa willayta rikuchinku sichus mana ISO formatoyuq p’unchaw kaskayuq waqyasqa (mana iskay kaq argumento munasqa formato kaqwan qusqapas). Temporal nisqaqa huk p'unchaw kaskaq específicamente formatochasqallatam t'aqwinqa. Watiqa ISO 8601 formatowan utaq mast'ariyninwan tupaq kanan tiyan, RFC 9557. Mana hunt'aq p'unchaw kaskaq huk from métodoman pasasqa, Temporal huk RangeError wikch'unqa.
// RFC 9557 p'unchaw kaskaqta llamk'achispa const p'unchawniy = Temporal.Instant.from ('2026-02-21T09:00:00-05:00[América/Nueva_York]'); console.log (myDate.toString ({ pacha Zone: 'América/Nueva_York' })); // 2026-02-21T09:00:00-05:00
// Mana riqsisqa p'unchaw kaskaqta llamk'achispa const hukP'unchaw = Temporal.Instant.from ('2/21/26 9:00:00'); // RangeError: Tiempo pantay: Mana allin qillqa wata chanin t'aqwichkaspa.
P’unchaw kaskaqpa chiqan mañakuyninkuna mayqin laya Temporal objeto ruwasqaykimanta kanqa. Hawa rikch'anapi, Temporal.Instant hunt'asqa ISO nisqatam munan. const p'unchawniy = Temporal.LlanoP'unchaw.manta ('2026-02-21'); console.log (ñuqa p'unchaw.mantaString ()); // 2026-02-21 watapi
const pachay = Temporal.LlanoTiempo.manta ('09:00:00'); console.log (Tiempoy.mantaString ()); // 09:00:00 pacha
Reparay kay watiqakunaqa suyasqa rikch'ayman hinaraqmi kanan, mana chayqa pantaymi wikch'usqa kanqa.
// Mana hunt'aq pacha kaskaqkunata llamk'achispa. Kaykunaqa llapankum huk RangeError nisqatam wischunqaku. Temporal.Tiempo Llano.manta ('9:00'); Temporal.Tiempo Llano.manta ('9:00:00 AM');
Pro yuyaychay: Mana ISO kaq kaskakunata hap’iyTemporal atiyniyuq kayta ñawpaqman churasqanrayku, mana 02-01-2026 hina kaskaqpa formaton adivinayta munanqachu. Sichus willay pukyuyki chayhina watiqakunata llamk'achin, wakin watiqa llamk'achiyta ruwanayki tiyan chanikunata ISO watiqaman musuqmanta churanaykipaq 2026-02-01 hina manaraq Temporal kaqwan llamk'achiyta munachkaspa.
Formato ruway Huk kuti huk Momento utaq Temporal objetoyuq kanki, ichapas huk pacha formatoyuq kaskaman tikrayta munanki. Kayqa huk instancia maypichus Moment aswan pisi pisilla kachkan. Objeto formato métodota waqyanki huk cadena tokenkunawan mayqinkunachus munasqa p’unchaw formatomanta willan. const p'unchaw = ratu ();
consola.log (p'unchaw.formato ('MM / DD / YYYY')); // 02/22/2026 watapi
console.log (p'unchaw.formato ('MMMM Ruway YYYY, h: mm: ss huk')); // 22 ñiqin pawqar waray killapi 2026 watapi, 20:18:30 pacha
Huk ladumantaq, Temporal nisqapiqa aswan rimaysapa kanayki tiyan. Tiempo kaqmanta imakuna, ahinataq Instant, toLocaleString ruwanayuq kanku, chaymanta imaymana formato akllanakunata chaskikun, huk imayaypa propiedades hina nisqa.
const p'unchaw = Temporal.Kunan.instant ();
// mana argumentoyuq, kunan localepaq ñawpaqmanta ruwasqa formatota chaskisunchik console.log (p'unchaw.LlocaleString nisqaman ()); // 2/22/2026, 20:23:36 PM (en-US nisqamanta huk locale nisqata hapispa)
// formato akllanakunata pasay huk sapanchasqa formato watiqa paqarichinanpaq console.log (p'unchaw.LlocaleString('as-US', { killa: 'unay', . p'unchaw: 'yupay', . wata: 'yupay', . hora: '2 yupayniyuq', . minuto: '2 yupayniyuq'. })); // 22 ñiqin pawqar waray killapi 2026 watapi 20:23 p'unchawpi
// formato kaskapi munasqayki chakrakunallata pasay console.log (p'unchaw.LlocaleString('as-US', { killa: 'pisi', . p'unchaw: 'yupa'. })); // 22 ñiqin pawqar waray killapi
P'unchaw pacha formato chiqamanta Intl.DateTimeFormat API (kayqa kunan pacha maskaqkunapi chaylla tarikunña) capucha urapi llamk'achin. Chayqa niyta munan huk musuqmanta llamk'achinapaq DateTimeFormat kaqmanta ruwayta atikunki sapanchasqa formato akllanaykikunawan, chaymanta Temporal kaqmanta ruwanakuna formato ruwayninman pasay. Kayrayku, mana yanapanchu sapanchasqa p’unchaw formatokuna Moment hina. Sichus imapas 'Q1 2026' hina utaq wak especializado formato necesitanki, wakin sapanchasqa p'unchaw formato codigo utaq huk kimsa kaq bibliotecaman chayayta necesitanki. const formato = musuq Intl.P'unchawTiempoFormato('en-US', { killa: '2 yupayniyuq', . p'unchaw: '2 yupayniyuq', . wata: 'yupay'. });
const p'unchaw = Temporal.Kunan.instant (); console.log (formator.formato (p'unchaw)); // 02/22/2026 watapi
Moment’s formato tokenkuna aswan sasan qillqanapaq, ichaqa mana locale-amigochu kanku. Formatoqa “hard code” nisqa kaqkunata killa/p’unchaw orden hina kaskachan. Huk ruwana objeto llamk'achiyta allinninqa, Temporal hina, kikinmanta mayqin qusqa kitimanpas tupachinqa chaymanta allin formato llamk'achinqa. const p'unchaw = Temporal.Kunan.instant ();
const formatAkllanakuna = { . killa: 'yupay', . p'unchaw: 'yupay', . wata: 'yupay'. };
console.log (p'unchaw.toLocaleString ('en-US', formatoAkllanakuna)); // 22/2/2026 watapi
console.log (p'unchaw.mantaLocaleString ('en-GB', formatoAkllanakuna)); // 22/02/2026 watapi
P’unchaw yupaykuna Askha ruwanakunapi, wakin yupaykunata huk p’unchawpi ruwayta tukunayki tiyan. Unidades de tiempo (p'unchawkuna, horakuna, segundokuna, hukkunapas) yapayta utaq qichuyta munankiman. Ejemplopaq, sichus kunan p'unchawniyuq kanki, ichapas 1 simanamanta p'unchawta ruwaqman rikuchiyta munanki. Momento objetokunaqa yapay, qichuy hina métodoyuqmi, chaykunam kay llamk'aykunata ruran. Kay llamkanakuna huk chaniyuqta chaymanta huk unidadta hapinku, kayhina: add(7, 'p'unchawkuna'). Ichaqa Momentowan Temporalwan huk ancha chaniyuq chikan kaymi, kay p'unchaw yupaykunata ruwaspaqa, chaypi kaq imapas tikrasqa, ñawpaq chanin chinkapun. const kunan = ratu ();
consola.log (kunan); // Rato<2026-02-24T20:08:36-05:00>
const nextWeek = kunan.yapay (7, 'p'unchawkuna'); console.log (qhipa simana); // Rato<2026-03-03T20:08:36-05:00>
// Gotcha - ñawpaq kaq imapas tikrasqa karqan consola.log (kunan); // Rato<2026-03-03T20:08:36-05:00>
Ñawpaq p'unchawta mana chinkachinapaq, Moment kaqpi clone waqyayta atikunki huk copiata ruwanaykipaq. const kunan= ratu (); const qatiqSemana = kunan.clone ().yapay (7, 'p'unchawkuna');
consola.log (kunan); // Rato<2026-02-24T20:12:55-05:00>
console.log (qhipa simana); // Rato<2026-03-03T20:12:55-05:00>
Hukninpiqa, Temporal nisqa objetokunaqa mana tikrakuqmi. Huk kuti huk Objeto Instant, PlainDate, chaymanta wakkuna hina ruwarqanki, chay objeto chanin mana hayk’aqpas tikranqachu. Objetos temporal nisqakunapas yapay, qichuy ruwaykunayuqmi. Temporal nisqaqa huk chhika akllakuqmi mayqin pacha unidadkuna mayqin objeto layakunaman yapasqa kanman chaymanta. Ejemplopaq, mana p’unchawkunata yapayta atikunkichu huk Instant kaqman:
const kunan = Temporal.Kunan.instant (); const qatiqSimana = kunan.yapay ({ p'unchawkuna: 7 }); // RangeError: Pacha pantay: Aswan hatun unidadqa manam p'unchaw unidad kanmanchu
Kayqa Instant objetokuna UTC kaqpi huk pacha pachata riqsichisqankurayku chaymanta calendario-agnostico kasqankurayku. Imaraykuchus huk p’unchawpa unayniyuq kayninqa tikrakunman pacha zona kamachiykunamanhina P’unchaw Waqaychay pacha hina, kay yupayqa mana huk Instant kaqpi kanchu. Ichaqa kay llamk'ayta huk laya imakuna kaqpi ruwayta atikunki, ahinataq PlainDateTime kaqpi: const kunan = Temporal.Kunan.llanoPunchawTiempoISO (); console.log (kunan.LlocaleString nisqaman ()); // 24/24/2026, 20:23:59 pacha
const qatiqSimana = kunan.yapay ({ p'unchawkuna: 7 });
// Reparay, ñawpaq PlainDateTime mana tikrasqalla kasqanmanta console.log (kunan.LlocaleString nisqaman ()); // 24/24/2026, 20:23:59 pacha
console.log (qhipa simana.mantaLocaleString ()); // 3/3/2026, 20:23:59 pacha
Hinallataqmi yupayta atinki hayk'a pacha iskay Momento utaq Temporal objetokunapura kasqanmanta. Moment’s diff ruwaywan, huk unidadta granularidadpaq qunayki tiyan, mana chayqa milisegundos kaqpi chiqanchayta kutichinqa. const p'unchaw1 = ratu ('2026-02-21T09:00:00'); const p'unchaw2 = ratu ('2026-02-22T10:30:00');
console.log (p'unchaw2.diff (p'unchaw1)); // 91800000 nisqapi
console.log (p'unchaw2.diff (p'unchaw1, 'p'unchawkuna')); // 1. 1.1
Kayta huk Temporal objetowan ruwanapaq, huk Temporal objetota payman pasayta atikunki chaymanta chaykama utaq chaymanta métodos kaqninman. Kayqa huk Temporal.Duration objeto nisqatam kutichin, chaypim pacha chikan kayninmanta willakuy kachkan. Unay pacha objeto sapa componente kaqpaq propiedadesniyuq kan, chaymanta huk ISO 8601 duracion watiqa ruwayta atin, pacha chikan kayninta riqsichiq.
const p'unchaw1 = Temporal.LlanoP'unchawTiempo.manta ('2026-02-21T09:00:00'); const p'unchaw2 = Temporal.LlanoP'unchawTiempo.manta ('2026-02-22T10:30:00');
// largestUnit aswan hatun pacha unidadta riqsichinapaq riqsichin // unay pacha yupaypi const diff = p'unchaw2.since (p'unchaw1, { aswan hatunUnidad: 'p'unchaw' });
consola.log (diff.p'unchawkuna); // 1. 1.1
consola.log (diff.horas); // 1. 1.1
consola.log (diff.minutos); // 30
consola.log (diff.mantaString ()); // P1DT1H30M nisqa // (ISO 8601 unayniyuq kaska: 1 p'unchaw, 1 pacha, 30 minutu)
Fechas Y Horas Comparar Moment chaymanta Temporal iskayninku p'unchawkuna chaymanta pachakuna tupachiyta saqinku mayqinkuna hukninmanta ñawpaqta hamun chayta yachanaykipaq, ichaqa hukniray ruwaykunata API kaqwan hap'iy. Moment isBefore, isAfter, isSame nisqa ruwaykunata qun iskay Moment objetokunata tupachinapaq. const p'unchaw1 = ratu ('2026-02-21T09:00:00'); const p'unchaw2 = ratu ('2026-02-22T10:30:00');
console.log (p'unchaw1.Manaraq (p'unchaw2)); // chiqap
Temporal nisqaqa huk tupachiy estático nisqatam llamk'achin, iskay kaqlla rikch'aq kaqkunap tupachiyninta ruranapaq. -1 kutichin sichus ñawpaq p'unchaw iskay kaq p'unchawmanta ñawpaqta hamun, 0 kaqlla kaptinku, icha 1 ñawpaq p'unchaw iskay kaq p'unchawmanta qhipaman hamun. Kay qatiq ejemploqa iskay PlainDate objetokunata tupachiyta qawachin. Iskaynin argumentokuna Temporal.PlainDate.compare kaqman PlainDate objetokuna kanan tiyan.
const p'unchaw1 = Temporal.PlainDate.from({ wata: 2026, killa: 2, p'unchaw: 24 }); const p'unchaw2 = Temporal.PlainDate.from({ wata: 2026, killa: 3, p'unchaw: 24 });
// p'unchaw1 hamun p'unchaw2 ñawpaqman, chayrayku -1 console.log (Temporal.PlainDate.comparar (p'unchaw1, p'unchaw2));
// Pantasqa sichus iskay imaymana laya objetokunata tupachiyta munanchis chayqa console.log (Temporal.PlainDate.compare (p'unchaw1, Temporal.Kunan.instant ())); // TypeError: Pacha pantay: Mana allin PlainDate pampakuna qusqa.
Aswantaqa, kayqa huk matriz Temporal objetokunata cronológicamente t'aqayta facilta ruwan. // Temporal.PlainDate kaqkunamanta huk matriz const p'unchawkuna = [ ... ];
// Temporal.PlainDate.compare nisqawan tupachiq ruwana hina llamk'achiy p'unchawkuna.sort(Temporal.PlainP'unchaw.tupachiy);
Tiempo Zona Tikraykuna Core Moment biblioteca mana pacha kiti tikraykunata yanapanchu. Sichus kay ruwayta necesitanki, chaymanta moment-timezone paqueteta churanayki tiyan. Kay paqueteqa manam sach'a-kuyuriqchu, chayraykutaqmi anchata yapayta atin paquete sayayniykiman. Huk kuti moment-timezone churasqaña, Moment objetokunata hukniray pacha zonakunaman tikrayta atikunki tz métodowan. Imaynan huk Moment operaciones kaqwan, kayqa subyacente kaqta mutaima. // EE.UU.-pa inti lluqsimuy pachata suyaspa const kunan = ratu (); consola.log (kunan); // Rato<2026-02-28T20:08:20-05:00>
// Pacífico pachaman tikray. // Inti lluqsimuy pacha qallariy pacha chinkapun. now.tz ('América/Los_Angeles'); consola.log (kunan); // Rato<2026-02-28T17:08:20-08:00>
Tiempo zona ruwana Temporal API kaqpi ruwasqa kachkan mayk'aq huk Temporal.ZonedDateTime objeto kaqwan llamk'achkanki. Kay imakuna huk withTimeZone ruwayta churan chaymanta musuq ZonedDateTime kutichin kikin pachata pachapi riqsichiq, ichaqa nisqa pacha kitipi. // Yapamanta, EE.UU. Oriente pachata suyaspa const kunan = Temporal.Kunan.zonadoPunchawTiempoISO (); console.log (kunan.LlocaleString nisqaman ()); // 28/28/2026, 20:12:02 pacha EST
// Pacífico pachaman tikray const kunanPacífico = kunan.withTimeZone ('América/Lista_Angeles'); console.log (kunan Pacífico.mantaLocalString ()); // 28/28/2026, 17:12:02 pacha PST
// Ñawpaq kaq imapas mana tikrasqallam kachkan console.log (kunan.LlocaleString nisqaman ()); // 28/28/2026, 20:12:02 pacha EST
Qhaway: toLocaleString kaqwan kutichisqa formatoyuq chanikuna, suti nisqanmanhina, kitimanta hapirin. Muestra código en-US locale kaqpi ruwasqa karqa, chayrayku formato kayhina: 2/28/2026, 5:12:02 PM PST. Huk locale nisqapiqa hukniraymi kanman. Ejemplopaq, en-GB locale kaqpi, imapas 28/2/2026, 17:12:02 GMT-8 hina tarinkiman. Huk Chiqap pachamanta Refactorización Yuyaykuy huk app ruwachkayku ruwaykunata programanapaq tukuy pacha zonakunapi. Kay ruwanamanta huknin huk ruwana, getEventTimes, mayqinchus huk ISO 8601 watiqmanta hapin, mayqinchus ruway pachata chaymanta p'unchawta riqsichin, huk kiti pacha kitita chaymanta huk meta pacha kitita. Ruwayqa iskaynin pacha kitikunapi ruwaypaq formatochasqa pacha chaymanta p'unchaw kaskaqkunata ruwan. Sichus ruwana huk yaykusqa kaskaq qusqa mana allin pacha/p’unchaw kaskaq, pantayta wikch’unqa. Kaypi ñawpaq ruway kachkan, Moment kaqwan (hinallataq moment-timezone paquete llamk’achiyta munan).
'momento-tiempo zona' nisqamanta momentota apamuy;
function getEventTimes(yaykuchiyString, userTimeZone, targetTimeZone) { const pachaFormato = 'MMM D, YYYY, h:mm:ss huk z';
// 1. Ruwaqpa pachanpi qallariy pachata ruway const sucesoTiempo = momento.tz ( . yaykusqaString, . moment.ISO_8601, // ISO 8601 watiqata suyay chiqap, // Sinchi t'aqwiy userTimeZone nisqa );
// Pantasqata wikch'uy sichus inputString mana allin p'unchawta rikuchirqanchu sichus (! sucesoTiempo.Valid ()) { . throw new Error('Mana allin p'unchaw/pacha yaykuy'); } .
// 2. Yupay chay meta pachata // CRITICAL: ¡Clonananchismi, mana chayqa 'eventTime' wiñaypaqmi cambian! const targetTime = eventoTiempo.clone ().tz (targetTimeZone);
kutiy { . local: eventoTiempo.format(tiempoFormato), . target: targetTime.format(tiempoFormato), . }; } .
const horario = tariyEventTimes( '2026-03-05T15:00-05:00', 'América/Nueva_York', 1999 watapi. 'Iwrupa/Londres', 1999 watapi. );
consola.log (horario.local); // 5 ñiqin ayamarq'a killapi 2026 watapi, 15:00:00 pacha EST
consola.log (horario.meta); // 5 ñiqin ayamarq'a killapi 2026 watapi, 20:00:00 pacha GMT
Kay rikch’anapi, huk suyasqa p’unchaw formato ISO 8601 kaqmanta llamk’achkayku, mayqinchus yanapakuq Moment kaqpi ruwasqa kachkan. Hinallataq sinchi t’aqwiyta llamk’achkayku, chaytaq niyta munan Moment mana p’unchaw kaskaqwan adivinayta munanqachu mana formatowan tupaq. Mana ISO p'unchaw watiqa pasasqa kaptinqa, mana allin p'unchaw objeto nisqatam qunqa, pantaytataq wikch'uyku. Temporal implementacionqa rikchakun, ichaqa huk pisi llalliq chikanchakuyniyuq.
function getEventTimes(yaykuchiyString, userTimeZone, targetTimeZone) { // 1. Yaykusqata chiqanmanta huk Instant nisqaman t'aqwiy, chaymanta ruway // huk ZonedDateTime llamk'achiqpa zonanpi. const instant = Temporal.Instant.manta (yaykuchiyString); const eventoTiempo = instant.toZonedDateTimeISO (ruraqpa pachan Zona);
// 2. Zona meta nisqaman tikray // Kayqa kikinmantam kutichin MUSUQ imapas; 'eventTime' nisqa mana imamanta manchachikuqmi. const targetTime = eventoTiempo.withTimeZone (targetTimeZone);
// 3. Intl (instruido) nisqawan formato ruway . const akllanakuna = { . wata: 'yupay', . killa: 'pisi', . p'unchaw: 'yupay', . hora: 'yupa', . minuto: '2 yupayniyuq', . iskay kaq: '2 yupayniyuq', . pachaZoneName: 'pisi'. };
kutiy { . llaqta: eventTime.toLocaleString(navigator.simi, akllanakuna), target: targetTime.toLocaleString(navegador.simi, akllanakuna) }; } .
const horario = tariyEventTimes( '2026-03-05T15:00-05:00', 'América/Nueva_York', 1999 watapi. 'Iwrupa/Londres', 1999 watapi. );
consola.log (horario.local); // 5 ñiqin ayamarq'a killapi 2026 watapi, 15:00:00 pacha EST
consola.log (horario.meta); // 5 ñiqin ayamarq'a killapi 2026 watapi, 20:00:00 pacha GMT
Moment kaqwan, sut'imanta huk formato watiqata ninanchik tiyan chaymanta lluqsisqa p'unchaw watiqakunapaq. Maypichus llamk’achkan utaq maypichus kachkan chaypas, ruway pachakuna sapa kuti Mar 5, 2026, 3:00:00 hina formatochasqa kanqapm EST nisqapi. Hinallataq, manan explícitamente huk excepción nisqataqa wikch’unanchischu. Sichus huk mana allin watiqa Temporal.Instant.from kaqman pasasqa, Temporal ñuqaykupaq excepción kaqta wikch'unqa. Huk kaqninmi qawanapaq, sinchi t'aqwiywanpas, Moment kaqpa laya aswan llamp'ullaraqmi. Temporal nisqaqa watiqap tukukuyninpi pacha kitip t'inkisqa kaynintam munan. Hinallataq, qhawanayki tiyan kay navigator.language llamk’achkasqaykurayku, kay codigo huk maskaq muyuriqllapi purinqa, imaynachus navigator mana huk Node.js muyuriqpi riqsichisqachu. Temporal ruwayqa maskaqpa kunan kitin (navigator.language) llamk’achin, chayrayku ruwaq kikinmanta ruway pachakunata llaqta pacha formato kaqninpi formatoyuqta chaskinqa. En-US locale nisqapi, kayqa 5 ñiqin ayamarq'a killapi 2026 watapi, 3:00:00 pm EST. Ichaqa, sichus llamk'achiq Londres llaqtapi kachkan, huk rikch'anapaq, ruway pachakuna 5 Mar 2026, 15:00:00 GMT-5 hina formatochasqa kanqa. Resumen
Ruray Momento.js Temporal nisqa Kunan pacha ratu() . Temporal.Kunan.zonadoPunchawTiempoISO() . ISO nisqamanta t'aqwiy ratu(str) . Temporal.Instant.de(str) nisqamanta. Tiempota yapay .yapay(7, 'p'unchawkuna') (mutacion) . .add({ p'unchawkuna: 7 }) (musuq imapas) . Diferencia .diff(huk, 'urakuna') .mantapacha(huk).horas Zona horaria .tz('Zona/Suti') . .withTimeZone('Zona/Suti') .
Ñawpaq qhawaypi, chiqan kayqa pisi hukniray kanman (hinallataq Temporal kaqpi, wakin kuti aswan rimaysapa chaymanta aswan sinchi) sintaxis kaqpi, ichaqa kanmi achka llalliq ventajakuna Temporal llamk'achinapaq Moment.js kaqmanta:
Aswan sut'i kayqa aswan pisi musphaykunata, mana yuyasqa pantaykunata ima niyta munan. Ratoqa aswan llamp’u sonqomanmi rikch’akunman, ichaqa “adivinación” nisqawanmi ruwakun, chaymi mayninpiqa mana allintachu p’unchaykuna ruwakunman. Temporalman mana allin kaqta qunki chayqa, pantayta wikch'un. Sichus código purin chayqa, yachanki allin p’unchayniyuq kasqaykita. Moment ruwanapa paquete kaqninman hatun sayayta yapayta atin, aswanta sichus moment-timezone paqueteta llamk’achkanki. Temporal mana imatapas yapanchu (huk kuti chaymanta apachisqa chay target navegadorniykikunapi). Mana tikray atiyqa qusunki mana hayk’aqpas willayta chinkachinkichu utaq qillqanki p’unchaw tikraykunata chaymanta ruwanakuna ruwachkanki. Hukhina pacha rikuchiykuna (Instant, PlainDateTime, ZonedDateTime) munasqaykimanhina, maypi Moment sapa kuti huk UTC pacha sello muyuriqpi p'istuyku. Temporal Intl APIkuna p'unchaw formatopaq llamk'achin, chaymanta niyta munan locale-yachaq formatoyuq kayta atikunki mana sut'imanta tokenkuna ninayki tiyan.
Notas Sobre El Polillenado Ñawpaqta nisqanchis hina, kanmi huk Temporal polyfill nisqa, huk npm paquete hina rakisqa @js-temporal/polyfill sutiyuq. Sichus kunan pacha Temporal llamk’ayta munanki, kay polyfill necesitanki Safari hina navegadorkunata yanapanapaq mayqinkunachus manaraq APIta apachinkuchu. Kaywan mana allin willakuyqa, paqueteykipa sayayninman yapanqa. Allin willakuyqa, hinallataqmi yapan ancha pisita momentomanta utaq momento-zona horariamanta. Kaypi huk tupachiy kachkan Bundlephobia.com willasqa hina paquete sayayninkunamanta, huk web kiti npm paquete sayaykunamanta willayta rikuchin (sapa paquete sutipi ñit'iy Bundlephobia t'aqwiyta qhawanaykipaq):
Paquete Minificasqa Minificado & gzipped @js-temporal/polillenado nisqa 154,1 kB 44,1 kB momento 294,4 kB 75,4 kB momento-tiempo nisqa 1 MB 114,2 kB
Polífill kaqpas ñawpaqmantapacha wakin ruway sasachakuyniyuq karqan yuyarina llamk’achiyta muyuriqpi, chaymanta qillqay pacha, huk alfa estado kaqpi qhawasqa. Chayrayku, manapaschá ruruchiypi llamk'achiyta munankichu aswan puqusqa kayninman chayanankama. Huk allin willakuyqa suyakuywan polyfill mana aswan unaytachu necesitakunqa (manachus ñawpaq navegadorkunata yanapanayki tiyan, chiqamanta). Kay qillqasqa pacha, Temporal Chrome, Edge chaymanta Firefox kaqpi apachisqa. Safari kaqpi manaraq allintachu wakichisqa kachkan, ichaqa huk puriy pacha banderawan qhipa Tecnología Ñawpaq qhawaypi tarikuq hina rikukun.
