Hoo e ka bang mofuta ofe kapa ofe wa kopo e ngotsweng ka JavaScript e sebetsa ka dinako kapa matsatsi ka bokgoni bo itseng. Kwa tshimologong, seno se ne se lekanyeditswe go API ya Letlha e e ageletsweng. API ena e kenyelletsa tshebetso ya motheo, empa e lekanyeditswe haholo ho seo e ka se etsang. Dilaeborari tsa motho wa boraro tse di jaaka Moment.js, le di-API tse di ageletsweng moragonyana tse di jaaka di-API tsa Intl le API e ntšha ya Nakwana, di oketsa go fetofetoga le maemo thata mo go direng ka dinako le matlha. Go Tsoga le go Wa ga Moment.js Moment.js ke laeborari ya JavaScript e e nang le ditiriso tse di maatla tsa go dira ka dinako le matlha. E akaretsa dikarolo tse di tlhaelang go tswa mo API ya motheo ya Letlha, tse di jaaka go dirisa nako ka tsela e e sa siamang, mme e dira gore ditiro tse dintsi tse di tlwaelegileng di nne bonolo. Motsotso gape o akaretsa ditiro tsa go fometa matlha le dinako. E ne ya nna laeborari e e dirisiwang thata mo ditirisong tse dintsi tse di farologaneng. Le fa go ntse jalo, Moment le yone e ne e na le karolo ya yone ya dikgang. Ke laeborari e kgolo, mme e ka oketsa thata bogolo jwa ngatana ya tiriswa. Ka gonne laeborari ga e tshegetse go tshikinya ditlhare (ntlha ya diphuthelwana tsa segompieno tse di kgonang go tlosa dikarolo tse di sa dirisiweng tsa dilaeborari), laeborari yotlhe ya Moment e akareditswe le fa o dirisa fela tiro e le nngwe kgotsa di le pedi tsa yone. Kgang e nngwe ka Moment ke gore dilo tse e di tlhamang di a fetoga. Go bitsa ditiro tse di rileng mo selong sa Moment go na le ditlamorago mme go fetola boleng jwa selo seo. Seno se ka baka boitshwaro jo bo sa lebelelwang kgotsa dikhukhwana. Ka 2020, batlhokomedi ba Moment ba ne ba swetsa ka gore ba tsenye laeborari mo seemong sa go tlhokomela. Ga go na tlhabololo e ntšhwa ya dikarolo e e dirwang, mme batlhokomedi ba akantsha kgatlhanong le go e dirisa mo diporojekeng tse dišwa. Go na le dilaeborari tse dingwe tsa matlha tsa JavaScript, tse di jaaka date-fns, mme go na le motshameki yo mosha mo toropong, API e e ageletsweng ka tlhamalalo mo JavaScript: Nakwana. Ke tekanyetso e ntšhwa e e tlatsang dikhutsi tsa API ya Letlha la ntlha mmogo le go rarabolola dingwe tsa dikgoreletsi tse di fitlhelwang mo Moment le mo dilaeboraring tse dingwe. Ke Eng sa Nakwana? Nakwana ke API e ntšhwa ya nako le letlha e e tsenngwang mo seemong sa ECMAScript, se se tlhalosang JavaScript ya segompieno. Ho tloha ka Hlakubele 20266, e fihlile Kgatong ya 4 ya tshebetso ya TC39 (komiti e okametseng ditshisinyo le ditlatsetso tsa puo ya JavaScript), mme e tla kenyeletswa mofuteng o latelang wa tlhaloso ya ECMAScript. E setse e tsentswe tirisong mo dibatling di le mmalwa: Chrome 144+ le Firefox 139+, mme Safari e solofetswe go latela mo bogautshwaneng. Polyfill e teng gape mo dibatling tse di sa tshegediweng le Node.js. API ya Nakwana e tlhama dilo tse, ka kakaretso, di emelang metsotso mo nakong. Tsena e ka nna ditempe tsa nako e tletseng le tsa letsatsi sebakeng sa nako se itseng, kapa e ka ba mohlala o akaretsang wa nako ya “tshupanako ya lebota” ntle le tlhahisoleseding efe kapa efe ya sebaka sa nako kapa ya letsatsi. Dingwe tsa dikarolo tse dikgolo tsa Temporal di akaretsa:
Dinako tse di nang le matlha kgotsa tse di senang matlha.Selo sa Nakwana se ka emela nako e e rileng ka letlha le le rileng, kgotsa nako e e senang tshedimosetso epe ya letlha. Letlha le le rileng, le le senang nako, le lone le ka emelwa. Tshegetso ya kgaolo ya nako.Dilo tsa nakwana di itse kgaolo ya nako ka botlalo mme di ka fetolelwa go ralala dikgaolo tsa nako tse di farologaneng. Moment e tshegetsa dikgaolo tsa nako, le yona, fela e tlhoka laeborari ya tlaleletso ya kgaolo ya nako ya motsotso. Go sa fetoge.Fa selo sa Nakwana se setse se tlhamilwe, ga se ka ke sa fetolwa. Dipalo tsa nako kgotsa diphetolo tsa kgaolo ya nako ga di fetole selo se se ka fa tlase. Go na le moo, di tlhagisa selo se sesha sa Nakwana. 1-based indexing.Motswedi o o tlwaelegileng wa dikhukhwana tse di nang le API ya Letlha (mmogo le ka Motsotso) ke gore dikgwedi di na le ditshupane tsa lefela. Se se raya gore Ferikgong ke kgwedi ya 0, go na le kgwedi ya 1 jaaka rotlhe re tlhaloganya mo botshelong jwa mmatota. Temporal e baakanya seno ka go dirisa tshupane e e theilweng mo go 1 — Ferikgong ke kgwedi ya 1. E tsentswe mo sebatling. E re ka Temporal e le API mo sebatling ka bosone, ga e oketse sepe mo bogolong jwa ngatana ya tiriso ya gago.
Gape go botlhokwa go ela tlhoko gore API ya Letlha ga e tsamaye. Le fa Temporal e emisetsa API eno, ga e tlosiwe kgotsa ga e tlhole e dirisiwa. Ditiriso tse dintsi di ne di tla thubega fa dibatli di ne di ka tlosa API ya Letlha ka tshoganyetso. Le fa go ntse jalo, gape nna o gopotse gore Moment jaanong e tsewa e le porojeke ya bogologolo mo mokgweng wa tlhokomelo. Mo setlhogong sotlhe, re tla leba “diresipe” dingwe tsa go fudusetsa khoutu e e theilweng mo Motsotsong kwa API e ntšha ya Nakwana. A re simolole go dira diphetogo! Go Tlhama Dilo tsa Letlha le Nako Pele ga re ka dirisa matlha le dinako ka boferefere, re tshwanetse go tlhama dilo tse di di emelang. Go tlhama selo sa Motsotso se se emelang letlha le nako ya ga jaana, dirisa tiro ya motsotso. const jaanong = motsotso (); khonsole.log (jaanong); // Motsotso<21:26:29-05:00>
Selo seno jaanong se ka fometelwa kgotsa sa dirisiwa ka tsela e e sa siamang jaaka go tlhokega.
// fetolela go UTC //tlhagiso: Seno se fetola selo sa Moment mme se se tsenya mo mokgweng wa UTC! khonsole.pegelo (jaanong.utc ()); // Motsotso<2026-02-19T02:26:29Z>
// gatisa mogala o o fometetsweng - ela tlhoko gore o dirisa nako ya UTC jaanong console.log (jaanong.fomate ('MM / LETS / NGYYY hh: mm: ss a')); // 19/02/2026 02:27:07 mo mosong
Selo sa botlhokwa se o tshwanetseng go se gakologelwa ka Motsotso ke gore selo sa Motsotso ka metlha se akaretsa tshedimosetso ka ga nako le letlha. Fa o tlhoka fela go dira ka tshedimosetso ya nako, seno gantsi se siame, mme se ka baka boitshwaro jo bo sa lebelelwang mo maemong a a tshwanang le Nako ya Letsatsi kgotsa dingwaga tsa go tlola, mo letlha le ka nnang le tlhotlheletso mo dipalong tsa nako. Nakwana e fetofetoga le maemo. O ka tlhama selo se se emelang letlha le nako ya ga jaana ka go tlhama selo sa Temporal.Instant. Seno se emela ntlha ya nako e e tlhalosiwang ke nako fa e sa le ka “motlha” (bosigogare UTC ka Ferikgong 1, 1970). Temporal e ka supa motsotso ono ka nako ka nepo ya maemo a nanosecond. const jaanong = Nakwana.Jaanong.ka bonako ();
// bona di-nanosecond tse di tala fa e sa le ka nako eo console.log (jaanong.metsotswana yaNano ya motlha); // 177146634261200000n
// fomete ya UTC khonsole.log (jaanong.go Mogala ()); // 2026-02-19T01:55:27.844Z
// fomete ya kgaolo e e rileng ya nako khonsole.log (jaanong.goMogala ({Lefelo la nako: 'Amerika/New_York' })); // 2026-02-18T20:56:57.905-05:00
Temporal.Dilo tsa ka bonako le tsone di ka tlhamelwa nako le letlha le le rileng ka go dirisa mokgwa wa from static.
const myMotsotso = Nakwana.Motsotso.go tswa ('2026-02-18T21:10:00-05:00');
// Fometa motsotso mo kgaolong ya nako ya selegae. Ela tlhoko gore seno se laola fela // go fometa - ga go fetole selo jaaka moment.utc e dira. khonsole.log (katso ya me.go Mogala ({ Lefelo la nako: 'Amerika / New_York' })); // 2026-02-18T21:10:00-05:00
Gape o ka tlhama mefuta e mengwe ya dilo tsa Nakwana, go akaretsa le:
Letlha la Nakwana.Letlha le le Tlhamaletseng: Letlha le le senang tshedimosetso ya nako. Nako.Nako e e Tlwaelegileng: Nako e e senang tshedimosetso ya letlha. Nakwana.ZonedDateTime: Letlha le nako mo kgaolong e e rileng ya nako.
Nngwe le nngwe ya tseno e na le mokgwa wa go tswa o o ka bidiwang ka selo se se totobatsang letlha le/kgotsa nako, kgotsa mogala wa letlha o o tshwanetseng go tlhatlhobiwa. // Letlha fela const gompieno = Nakwana.Letlha le le Tlwaelegileng.go tswa ({ ngwaga: 2026, kgwedi: 2, // ela tlhoko gore re dirisa 2 ya Tlhakole letsatsi: 18 }); khonsole.log (gompieno.go Mogala ()); 2026-02-18
// Nako fela const Nako ya dijo tsa motshegare = Nako.Nako.Go tswa ({ ura: 12 }); console.log (Nako ya dijo tsa motshegare.go ya go Mogala ()); 12:00:00
// Letlha le nako mo kgaolong ya nako ya Botlhaba jwa US const dueAt = Nakwana.LetlhaNako.gotswa({ Lefelo la nako: 'Amerika/New_York', ngwaga: 2026, kgwedi: 3, letsatsi: 1, ura: 12, motsotso: 0, bobedi: 0 }); console.log (e e tshwanetsengAt.goMogala ()); // Amerika/New_York]
Go sekaseka Re akareditse go tlhama tshedimosetso ya letlha le nako ka thulaganyo. Jaanong a re lebeleleng go tlhatlhoba. Go sekaseka ke lefelo le lengwe le Motsotso o fetofetogang mo go lone go feta API ya Nakwana e e ageletsweng. O ka sekaseka mogala wa letlha ka go o fetisetsa kwa tirong ya motsotso. Ka ngangisano e le nngwe, Moment e lebeletse mogala wa letlha la ISO, fela o ka dirisa difomate tse dingwe fa o tlamela ka ngangisano ya bobedi e e totobatsang fomete ya letlha e e dirisiwang.
const isoLetlha = motsotso ('2026-21-09:00'); const Letlha le le rulagantsweng = motsotso ('21/2/26 9:00:00', 'M/M/NGA h:mm:ss');
khonsole.log (Letlha la iso); // Motsotso<2026-02-21T09:00:00-05:00>
console.log (Letlha le le fometetsweng); // Motsotso<2026-02-21T09:00:00-05:00>
Mo mefuteng ya bogologolo, Moment e ne e tla fopholetsa sentle go sekaseka mogala ope wa letlha o o rulagantsweng ka go sa tlhomamang. Seno se ka baka dipholo tse di sa bonelwang pele. Ka sekai, a 02-03-2026 ke Tlhakole 2 kgotsa Mopitlwe 3? Ka lebaka le, mefuta e mesha ya Moment e bontsha tlhagiso e e bonalang ya go nyatsa fa e bidiwa kwantle ga mogala wa letlha o o fometetsweng wa ISO (ntle le fa ngangisano ya bobedi e e nang le fomete e e batlegang le yone e neetswe). Temporal e tla sekaseka fela mogala wa letlha o o rulagantsweng ka tlhamalalo. Mogala o tshwanetse go tsamaisana le fomete ya ISO 8601 kgotsa katoloso ya one, RFC 9557. Fa mogala wa letlha o o sa tsamaisaneng o fetisediwa kwa mokgweng wa go tswa, Temporal e tla latlhela RangeError.
// Go dirisa mogala wa letlha wa RFC 9557 const Letlha la me = Nakwana.Ka bonako.go tswa ('Amerika/New_York]'); console.log (Letlha la me. go Mogala ({ Lefelo la nako: 'Amerika / New_York' })); // 2026-02-21T09:00:00-05:00
// Go dirisa mogala wa letlha o o sa itsiweng const Letlha le lengwe = Nakwana.Ka bonako.go tswa ('2/21/26 9:00:00'); // RangeError: Phoso ya nakwana: Tlhaka e e sa direng fa o ntse o sekaseka boleng jwa ngwaga.
Ditlhokego tse di tlhomameng tsa mogala wa letlha di ikaegile ka gore o tlhama selo sa mofuta ofe sa Nakwana. Mo sekaong se se fa godimo, Temporal.Instant e tlhoka ISO e e tletseng8601 kgotsa RFC 9557 mogala wa letlha o o totobatsang letlha le nako ka go fokodiwa ga kgaolo ya nako, mme gape o ka tlhama dilo tsa PlainDate kgotsa PlainTime o dirisa fela setlhotshwana sa fomete ya letlha. const Letlha la me = Letlha la Nakwana.Letlha le le Tlwaelegileng.go tswa ('2026-02-21'); console.log (Letlha la me. go Mogala ()); // 2026-02-21
const Nako ya me = Nako.Nako e e Tlwaelegileng.go tswa ('09:00:00'); console.log (Nako ya me.go Mogala ()); // 09:00:00
Ela tlhoko gore megala eno e santse e tshwanetse go tsamaisana le fomete e e solofetsweng, kgotsa go tla latlhelwa phoso.
// Go dirisa dikgwele tsa nako tse di sa tsamaisaneng le melao. Tseno tsotlhe di tla latlhela Phoso ya Range. Nako.Nako e e Tlwaelegileng.go tswa ('9:00'); Nako.Nako.Go tswa ('9:00:00 AM');
Tlhabo-botlhale: Go tshwara megala e e seng ya ISOKa gonne Temporal e baya go ikanyega kwa pele, ga e kitla e leka go fopholetsa fomete ya mogala o o tshwanang le 02-01-2026. Fa motswedi wa gago wa tshedimosetso o dirisa megala e e ntseng jalo, o tla tlhoka go dira ditiro dingwe tsa go dirisa megala go rulaganya gape boleng go nna mogala wa ISO jaaka 2026-02-01 pele o leka go e dirisa le Temporal.
Go fometa Fa o setse o na le selo sa Motsotso kgotsa sa Nakwana, gongwe o tla batla go se fetolela go nna mogala o o fometetsweng ka nako nngwe. Se ke tiragalo e mo go yone Moment e leng khutshwane go sekae. O bitsa mokgwa wa fomete ya selo ka motseletsele wa dithokene tse di tlhalosang fomete ya letlha le le batlegang. const letlha = motsotso ();
console.log (letlha.fomete ('MM / DD / YYYY')); // 22/02/2026
console.log (letlha.fomate ('MMMM Dira YYYY, h: mm: ss a')); // Tlhakole 22nd 2026, 8:18:30 bosigo
Ka fa letlhakoreng le lengwe, Temporal e tlhoka gore o nne le mafoko a mantsi go sekae. Dilo tsa nakwana, jaaka Instant, di na le mokgwa wa toLocaleString o o amogelang ditlhopho tse di farologaneng tsa go fometa tse di totobaditsweng jaaka dipharologantsho tsa selo.
const letlha = Nakwana.Jaanong.ka bonako ();
// kwantle ga dingangisano, re tla bona fomete ya thulaganyetsoruri ya lefelo la ga jaana console.log (letlha.go ya Lefelo la Mogala ()); // 22/2/2026, 20:23:36 maitseboa (re tsaya gore ke puo ya en-US)
// fetisa ditlhopho tsa fomete go tlhagisa mogala wa fomete e e tlwaelegileng console.log(letlha.goMogala waLefelo('en-US', { kgwedi: 'telele', letsatsi: 'dipalo', ngwaga: 'dipalo', ura: 'dinomoro tse 2', motsotso: 'dinomoro tse 2' })); // Tlhakole 22, 2026 ka 8:23 maitseboa
// fetisa fela dikarolo tse o di batlang mo moleng wa fomete console.log(letlha.goMogala waLefelo('en-US', { kgwedi: 'khutshwane', letsatsi: 'dipalo' })); // Tlhakole 22
Go fometa letlha la nakwana tota go dirisa Intl.DateTimeFormat API (e e setseng e le teng mo dibatling tsa segompieno) ka fa tlase ga hood. Seo se raya gore o ka tlhama selo sa DateTimeFormat se se ka dirisiwang gape ka ditlhopho tsa gago tsa go fometa tse di tlwaelegileng, o bo o fetisetsa dilo tsa Nakwana kwa mokgweng wa sone wa go fometa. Ka ntlha ya seno, ga e tshegetse difomete tsa letlha tse di tlwaelegileng jaaka Moment e dira. Fa o tlhoka sengwe se se tshwanang le 'Q1 2026' kgotsa go fometa go gongwe go go kgethegileng, o ka nna wa tlhoka khoutu ya go fometa letlha le le tlwaelegileng kgotsa wa fitlhelela laeborari ya motho yo mongwe. const mofomete = Intl.LetlhaNakoFomete e ntšhwa ('en-US', { kgwedi: 'dipalo-2', letsatsi: 'dinomoro tse 2', ngwaga: 'dipalo'. });
const letlha = Nakwana.Jaanong.ka bonako (); console.log (fomete.fomete (letlha)); // 22/02/2026
Dithokene tsa go fometa tsa Moment di bonolo go di kwala, mme ga di tshwanele selegae. The rulaganya dikgwele "thata khoutu" lintho tse kang kgwedi / letsatsi taelo. Mosola wa go dirisa selo sa thulaganyo, jaaka Temporal e dira, ke gore se tla ikamanya ka go itirisa le lefelo lengwe le lengwe le le neetsweng le go dirisa fomete e e nepagetseng. const letlha = Nakwana.Jaanong.ka bonako ();
Ditlhopho tsa fomete ya const = { kgwedi: 'dipalo', letsatsi: 'dipalo', ngwaga: 'dipalo'. };
console.log (letlha.goMogala waLefelo ('en-US', Dikgetho tsa fomete)); // 22/2/2026
console.log (letlha.goMogala waLefelo ('en-GB', Dikgetho tsa fomete)); // 22/02/2026
Dipalelo tsa letlha Mo ditirisong di le dintsi, o tla tlhoka go feleletsa o dira dipalelo dingwe ka letlha. O ka nna wa batla go oketsa kgotsa go ntsha diyuniti tsa nako (malatsi, diura, metsotswana, jj.). Ka sekai, fa o na le letlha la ga jaana, o ka nna wa batla go bontsha modirisi letlha beke e le 1 go tloga jaanong. Dilo tsa motsotso di na le mekgwa e e jaaka go oketsa le go ntsha e e dirang ditiro tseno. Ditiro tseno di tsaya boleng le yuniti, ka sekai: tsenya(7, 'malatsi'). Pharologanyo e le nngwe e e botlhokwa thata fa gare ga Moment le Temporal, le fa go ntse jalo, ke gore fa go dirwa dipalo tseno tsa letlha, selo se se kwa tlase se a fetolwa mme boleng jwa sone jwa ntlhantlha bo a latlhega. const jaanong = motsotso ();
khonsole.log (jaanong); // Motsotso<2026-02-24T20:08:36-05:00>
const Beke e e tlang = jaanong.tsenya (7, 'malatsi'); console.log (Beke e e tlang); // Motsotso<2026-03-03T20:08:36-05:00>
// Gotcha - selo sa ntlha se fetotswe khonsole.log (jaanong); // Motsotso<2026-03-03T20:08:36-05:00>
Go tila go latlhegelwa ke letlha la ntlha, o ka bitsa clone mo selong sa Moment go tlhama khopi. const jaanong= motsotso (); const Beke e e tlang = jaanong.clone (). oketsa (7, 'malatsi');
khonsole.log (jaanong); // Motsotso<2026-02-24T20:12:55-05:00>
console.log (Beke e e tlang); // Motsotso<2026-03-03-20:12:55-05:00>
Ka fa letlhakoreng le lengwe, dilo tsa Nakwana ga di fetoge. Fa o setse o tlhamile selo se se tshwanang le Instant, PlainDate, jalo le jalo, boleng jwa selo seo ga bo kitla bo fetoga. Dilo tsa nakwana le tsone di na le mekgwa ya go oketsa le go ntsha. Temporal ke picky e nyenyane ka hore ke diyuniti dife tsa nako tse ka eketswa ho mefuta efe ya ntho. Ka sekai, ga o ka ke wa tsenya malatsi mo Instant:
const jaanong = Nakwana.Jaanong.ka bonako (); const Beke e e tlang = jaanong.tsenya ({ malatsi: 7 }); // RangeError: Phoso ya nakwana: Yuniti e kgolo e ka se nne yuniti ya letlha
Seno ke ka gonne dilo tsa Instant di emela ntlha e e rileng ya nako mo UTC mme ga di amane le khalendara. Ka gonne boleele jwa letsatsi bo ka fetoga go ikaegile ka melao ya kgaolo ya nako e e jaaka Nako ya Letlhabula, palelo eno ga e yo mo Instant. O ka, le fa go ntse jalo, dira tiro eno mo mefuteng e mengwe ya dilo, tse di jaaka PlainDateTime: const jaanong = Nakwana.Jaanong.LetlhaNakoISO (); khonsole.log (jaanong.go Mogala waLefelo ()); // 24/2/2026, 20:23:59 maitseboa
const Beke e e tlang = jaanong.tsenya ({ malatsi: 7 });
// Ela tlhoko gore PlainDateTime ya ntlha ga e fetoge khonsole.log (jaanong.goMogala waLefelo ()); // 24/2/2026, 20:23:59 maitseboa
console.log (Beke e e tlang.go Mogala wa Lefelo ()); // 3/3/2026, 20:23:59 maitseboa
O ka bala gape gore ke nako e e kana kang fa gare ga dilo tse pedi tsa Motsotso kgotsa tsa Nakwana. Ka tiro ya Moment’s diff, o tlhoka go tlamela ka yuniti ya granularity, go seng jalo e tla busetsa pharologano ka dimilisekondi. const letlha1 = motsotso ('2026-02-21T09:00:00'); const letlha2 = motsotso ('2026-02-22T10:30:00');
console.log (letlha2.pharologano (letlha1)); // 91800000
console.log (letlha2.pharologano (letlha1, 'malatsi')); // 1
Go dira se ka selo sa Nakwana, o ka fetisetsa selo se sengwe sa Nakwana kwa mekgweng ya sone ya go fitlha kgotsa fa e sa le. Seno se busetsa selo sa Temporal.Duration se se nang le tshedimosetso ka ga pharologano ya nako. Selo sa Nako se na le dithoto tsa karolo nngwe le nngwe ya pharologano, mme gape se ka tlhagisa mogala wa nako wa ISO 8601 o o emelang pharologano ya nako.
const letlha1 = Nakwana.Letlha le le TlwaelegilengNako.go tswa ('2026-02-21T09:00:00'); const letlha2 = Nakwana.Letlha le le TlwaelegilengNako.go tswa ('2026-02-22T10:30:00');
// largestUnit e totobatsa yuniti e kgolo ya nako e e tshwanetseng go emela // mo palong ya nako const diff = letlha2.fa e sa le (letlha1, {Yuniti e kgolo: 'letsatsi' });
console.log (pharologano.malatsi); // 1
console.log (pharologano.diura); // 1
console.log (pharologano.metsotso); // 30
khonsole.log (pharologano.go Mogala ()); // P1DT1H30M // (Mogala wa nako ya ISO 8601: letsatsi le le 1, ura e le 1, metsotso e le 30)
Go Bapisa Matlha le Dinako Moment le Temporal ka bobedi di go letla go bapisa matlha le dinako go bona gore ke efe e e tlang pele ga e nngwe, mme o tseye mekgwa e e farologaneng le API. Motsotso o fana ka mekgwa e kang isPele, isMorao, le isSame ho bapisa dintho tse pedi tsa Motsotso. const letlha1 = motsotso ('2026-02-21T09:00:00'); const letlha2 = motsotso ('2026-02-22T10:30:00');
console.log (letlha1.kePele (letlha2)); // nnete
Temporal e dirisa mokgwa wa go bapisa o o sa fetogeng go dira papiso magareng ga dilo tse pedi tsa mofuta o o tshwanang. E busetsa -1 fa letlha la ntlha le tla pele ga la bobedi, 0 fa di lekana, kgotsa 1 fa letlha la ntlha le tla morago ga la bobedi. Sekao se se latelang se bontsha ka fa o ka bapisang dilo tse pedi tsa PlainDate ka teng. Dingangisano ka bobedi tsa Nakwana.Letlha le le Tlwaelegileng.bapisa di tshwanetse go nna dilo tsa Letlha le le Tlwaelegileng.
const letlha1 = Letlha la Nakwana.Letlha le le Tlwaelegileng.go tswa ({ ngwaga: 2026, kgwedi: 2, letsatsi: 24 }); const letlha2 = Letlha la Nakwana.Letlha le le Tlwaelegileng.go tswa ({ ngwaga: 2026, kgwedi: 3, letsatsi: 24 });
// letlha1 le tla pele ga letlha2, ka jalo -1. console.log (Nakwana.Letlha le le Tlwaelegileng.bapisa (letlha1, letlha2));
// Phoso fa re leka go bapisa dilo tse pedi tsa mefuta e e farologaneng console.log (Nakwana.Letlha le le Tlwaelegileng.bapisa (letlha1, Nakwana.Jaanong.ka bonako ())); // Phoso ya Mofuta: Phoso ya nakwana: Dikarolo tsa PlainDate tse di sa direng tse di neetsweng.
Segolobogolo, seno se dira gore go nne bonolo go tlhomaganya thulaganyo ya dilo tsa Nako ka tatelano ya ditiragalo. // Thulaganyo ya dilo tsa Letlha la Nakwana matlha a tlhomameng = [ ... ];
// dirisa Nakwana.Letlha le le Tlwaelegileng.bapisa jaaka tiro ya papiso matlha.tlhopha (Nakwana.Letlha le le Tlwaelegileng.bapisa);
Diphetogo tsa Lefelo la Nako Laeborari ya konokono ya Moment ga e tshegetse diphetogo tsa kgaolo ya nako. Fa o tlhoka tiriso eno, gape o tlhoka go tsenya sephuthelwana sa moment-timezone. Sephuthelwana se ga se tshikinyege ke setlhare, mme ka jalo se ka oketsa thata mo bogolong jwa ngatana ya gago. Fa o sena go tsenya moment-timezone, o ka fetolela dilo tsa Moment go nna dikgaolo tsa nako tse di farologaneng ka mokgwa wa tz. Jaaka ka ditiro tse dingwe tsa Moment, seno se fetolaselo. // Go tsaya gore nako ya Botlhaba jwa Amerika const jaanong = motsotso (); khonsole.log (jaanong); // Motsotso<2026-02-28T20:08:20-05:00>
// Fetolela go nako ya Pacific. // Nako ya ntlha ya Botlhaba e latlhegile. jaanong.tz ('Amerika / Los_Angelese'); khonsole.log (jaanong); // Motsotso<2026-02-28T17:08:20-08:00>
Tiro ya kgaolo ya nako e ageletswe mo API ya Nakwana fa o dirisa selo sa Nakwana.ZonedDateTime. Dilo tseno di akaretsa mokgwa wa withTimeZone o o busetsang ZonedDateTime e ntšhwa e e emelang motsotso o o tshwanang mo nakong, mme mo kgaolong ya nako e e beilweng. // Gape, re tsaya gore nako ya Botlhaba jwa Amerika const jaanong = Nakwana.Jaanong.zonedLetlhaNakoISO (); khonsole.log (jaanong.goMogala waLefelo ()); // 28/2/2026, 8:12:02 maitseboa EST
// Fetolela go nako ya Pacific const jaanongPacific = jaanong.kaLefelo laNako ('Amerika / Los_Angeles'); console.log (jaanongPacific.go ya Lefelo ()); // 28/2/2026, 5:12:02 maitseboa PST
// Selo sa ntlha ga se fetoge khonsole.log (jaanong.goMogala waLefelo ()); // 28/2/2026, 8:12:02 maitseboa EST
Ela tlhoko: Dipalopalo tse di fometetsweng tse di busediwang ke toLocaleString, jaaka leina le kaya, di ikaegile ka lefelo. Khoutu ya sekao e ne ya tlhamiwa ka puo ya en-US, ka jalo fomete e ntse jaana: 2/28/2026, 5:12:02 PM PST. Mo lefelong le lengwe, seno se ka nna sa farologana. Ka sekai, mo puong ya en-GB, o tla bona sengwe se se tshwanang le 28/2/2026, 17:12:02 GMT-8. Go Dira Sešwa ga Lefatshe la Mmatota A re re re aga tiriswa ya go rulaganyetsa ditiragalo go ralala dikgaolo tsa nako. Karolo ya tiriswa eno ke tiro, getEventTimes, e e tsayang mogala wa ISO 8601 o o emelang nako le letlha la tiragalo, lefelo la nako la selegae, le lefelo la nako le le ikaeletsweng. Tiro e tlhama megala ya nako le letlha e e rulagantsweng ya tiragalo mo dikgaolong tsa nako ka bobedi. Fa tiro e newa mogala wa tsenyo o e seng mogala wa nako/letlha o o amogelesegang, e tla latlhela phoso. Fano go tsenngwa tirisong ga ntlha, go dirisiwa Motsotso (gape o tlhoka tiriso ya sephuthelwana sa moment-timezone).
thomeloteng motsotso go tswa go 'motsotso-nako';
tiro bonaDinako tsaTiragalo (Mogala waTsenyo, Lefelo laNako la modirisi, Lefelo laNako le le ikaeletsweng) { const nakoFomate = 'MMM D, NGYYY, h: mm: ss a z';
// 1. Tlhama motsotso wa ntlha mo kgaolong ya nako ya modirisi const Nako ya tiragalo = motsotso.tz( Mogala wa Tsenyo, motsotso.ISO_8601, // Lebelela mogala wa ISO 8601 nnete, // Tlhatlhobo e e gagametseng Lefelo la Nako ya modirisi );
// Latlhela phoso fa inputString e ne e sa emele letlha le le siameng fa (!Nako ya tiragalo. e a Dira ()) { latlhela Phoso e ntšhwa ('Tsenyo ya letlha/nako e e sa direng'); }
// 2. Balela nako e e ikaeletsweng // BOTLHOKWA: Re tshwanetse go dira clone, kgotsa 'eventTime' e fetogela ruri! const Nako e e ikaeletsweng = Nako ya tiragalo.clone ().tz (Lefelo la Nako e e ikaeletsweng);
busetsa { selegae: TiragaloNako.fomete(nakoFomete), sepheo: sepheoNako.fomete(nakoFomate), }; }
const thulaganyo = bonaDinako tsaTiragalo( '03-05T15:00-05:00', 'Amerika/New_York', 'Yuropa/Londone', );
console.log (thulaganyo.ya selegae); // Mopitlwe 5, 2026, 3:00:00 thapama EST
console.log (thulaganyo.sepheo); // Mopitlwe 5, 2026, 8:00:00 maitseboa GMT
Mo sekaong seno, re dirisa fomete ya letlha le le solofetsweng la ISO 8601, le le tsenngwang mo Moment ka tsela e e thusang. Gape re dirisa go sekaseka ka tsela e e gagametseng, mo go rayang gore Motsotso ga o kitla o leka go fopholetsa ka mogala wa letlha o o sa tsamaisaneng le fomete. Fa mogala wa letlha o o seng wa ISO o fetisiwa, o tla felela ka selo sa letlha se se sa direng, mme re latlhela phoso. Go tsenngwa tirisong ga Nakwana go lebega go tshwana, mme go na le dipharologano di le mmalwa tsa botlhokwa.
tiro bonaDinako tsaTiragalo (Mogala waTsenyo, Lefelo laNako la modirisi, Lefelo laNako le le ikaeletsweng) { // 1. Tlhatlhoba tsenyo ka tlhamalalo mo Instant, o bo o tlhama // a ZonedDateNako mo kgaolong ya modirisi. const ka bonako = Nakwana.Ka bonako.go tswa (mogala wa tsenyo); const tiragaloNako = ka bonako.toZonedDateNakoISO (modirisiNakoLefelo);
// 2. Fetolela go kgaolo e e ikaeletsweng // Se se busetsa selo se SENTSHA ka go itirisa; 'Nako ya tiragalo' e babalesegile. const Nako e e ikaeletsweng = Nako ya tiragalo.ka Lefelo la Nako (Lefelo la Nako le le ikaeletsweng);
// 3. Fometa o dirisa Intl (e e ageletsweng) ditlhopho tsa const = { ngwaga: 'dipalo', kgwedi: 'khutshwane', letsatsi: 'dipalo', ura: 'dipalo', motsotso: 'dinomoro tse 2', bobedi: 'dinomoro tse 2', LeinaLefelonako: 'khutshwane' };
busetsa { selegae: TiragaloNako.goLocaleString (motsamaisi.puo, ditlhopho), sepheo: sepheoNako.go LocaleString (motsamaisi.puo, dikgetho) }; }
const thulaganyo = bonaDinako tsaTiragalo( '03-05T15:00-05:00', 'Amerika/New_York', 'Yuropa/Londone', );
console.log (thulaganyo.ya selegae); // Mopitlwe 5, 2026, 3:00:00 maitseboa EST
console.log (thulaganyo.sepheo); // Mopitlwe 5, 2026, 8:00:00 maitseboa GMT
Ka Motsotso, re tshwanetse go totobatsa ka tlhamalalo mogala wa fomete wa megala ya letlha e e tlholang. Go sa kgathalesege gore modirisi o kwa kae kgotsa o nna kae, dinako tsa tiragalo ka metlha di tla rulaganngwa jaaka Mar 5, 2026, 3:00:00thapama EST Gape, ga re tlhoke go latlhela mokgwa o o sa tlwaelegang. Fa mogala o o sa direng o fetisediwa kwa Nakwana.Instant.from, Nakwana e tla re latlhela mokgwa o o sa tlwaelegang. Selo se le sengwe se se tshwanetseng go elwa tlhoko ke gore le fa go tlhatlhobiwa ka tsela e e gagametseng, mofuta wa Moment o sa ntse o le bonolo thata. Temporal e tlhoka gore kgaolo ya nako e fokodiwe kwa bokhutlong jwa mogala. O tshwanetse go ela tlhoko gape gore e re ka re dirisa navigator.language, khoutu eno e tla dira fela mo tikologong ya sebatli, ka gonne navigator ga e a tlhalosiwa mo tikologong ya Node.js. Go tsenngwa tirisong ga Nakwana go dirisa lefelo la ga jaanong la sebatli (navigator.language), ka jalo modirisi o tla bona dinako tsa tiragalo di rulagantswe ka itiriso ka fomete ya nako ya gagwe ya lefelo leo. Mo puong ya en-US, eno ke Mopitlwe 5, 2026, ka 3:00:00 maitseboa EST. Le fa go ntse jalo, fa modirisi a le kwa Lontone, ka sekai, dinako tsa tiragalo di tla rulaganngwa jaaka 5 Mar 2026, 15:00:00 GMT-5. Tshobokanyo
Kgato Motsotso.js Ya nakwana Nako ya ga jaana motsotso() Nakwana.Jaanong.kgaoloLetlhaNakoISO() Go tlhatlhoba ISO motsotso (motlakase) Nakwana.Ka bonako.go tswa(str) Tsenya nako .tsenya(7, 'malatsi') (e a fetoga) .tsenya({ malatsi: 7 }) (selo se sešwa) Pharologano .pharologano(tse dingwe, 'diura') .fa e sale(tse dingwe).diura Kgaolo ya nako .tz('Kgaolo/Leina') .ka Lefelo la Nako('Lefelo/Leina')
Fa o leba la ntlha, pharologano e ka nna ya farologana go sekae (mme mo kgannyeng ya Temporal, ka dinako tse dingwe e na le mafoko a mantsi e bile e gagametse thata) popegopuo, mme go na le melemo e le mmalwa ya konokono ya go dirisa Temporal go feta Moment.js:
Go tlhamalala thata go raya dimakatso di le mmalwa le dikhukhwana tse di sa ikaelelwang. Motsotso o ka lebega o le bonolo thata, mme o akaretsa “go fopholetsa,” mo ka dinako tse dingwe go ka felelang ka matlha a a sa siamang. Fa o naya Temporal sengwe se se sa direng, e latlhela phoso. Fa khoutu e dira, o a itse gore o na le letlha le le dirang. Motsotso o ka oketsa bogolo jo bo bonalang mo ngataneng ya tiriswa, segolobogolo fa e le gore o dirisa sephuthelwana sa moment-timezone. Temporal ga e tsenye sepe (fa e sena go romelwa mo dibatlising tsa gago tse di ikaeletsweng). Go sa fetoge go go naya tshepo ya gore ga o kitla o latlhegelwa kgotsa o kwala tshedimosetso fa o dira diphetogo tsa matlha le ditiro. Ditshwantsho tse di farologaneng tsa nako (Nako ya Letlha la Ka bonako, Nako ya Letlha le le Tlhamaletseng, Nako ya Letlha la Kgaolo) go ikaegile ka ditlhokego tsa gago, moo Motsotso ka metlha e leng sephuthelo go dikologa setempe sa nako sa UTC. Temporal e dirisa di-API tsa Intl go fometa letlha, se se rayang gore o ka nna le fomete e e itseng lefelo kwantle ga go tlhoka go totobatsa dithokene ka tlhamalalo.
Dintlha ka Polyfill Jaaka go umakilwe pelenyana, go na le polyfill ya Nakwana e e leng teng, e e anamisiwang jaaka sephuthelwana sa npm se se bidiwang @js-temporal/polyfill. Fa o batla go dirisa Temporal gompieno, o tla tlhoka polyfill eno go tshegetsa dibatli tse di tshwanang le Safari tse di iseng di romele API. Dikgang tse di maswe ka seno ke gore se tla oketsa bogolo jwa ngata ya gago. Dikgang tse di molemo ke gore e sa ntse e oketsa thata go feta motsotso kgotsa motsotso-nako. Fano go na le papiso ya bogolo jwa diphuthelwana jaaka go begilwe ke Bundlephobia.com, webosaete e e tlhagisang tshedimosetso ka bogolo jwa diphuthelwana tsa npm (tobetsa mo leineng lengwe le lengwe la sephuthelwana go bona tshekatsheko ya Bundlephobia):
Sephuthelwana E fokoditswe E fokoditswe le go zipiwa @js-nakwana/tlatso e ntsi 154.1 kB 44.1 kB motsotso 294.4 kB 75.4 kB kgaolo ya nako ya motsotso 1 MB 114.2 kB
Polyfill gape e nnile le mathata a tiragatso mo tirisong ya memori, mme ka nako ya go kwala, e tsewa e le mo seemong sa alpha. Ka ntlha ya se, o ka nna wa se batle go e dirisa mo tlhagisong go fitlha e fitlha mo seemong se se godileng sentle. Dikgang tse dingwe tse di molemo ke gore ka tsholofelo polyfill ga e kitla e tlhokega nako e telele (ntle le fa o tlhoka go tshegetsa dibatli tsa bogologolo, e le ruri). Ka nako ya go kwala, Temporal e rometswe ka Chrome, Edge, le Firefox. Ga e ise e siamele gotlhelele mo Safari, le fa go lebega e le teng ka folaga ya nako ya go dira mo Tebopele ya Thekenoloji ya bosheng.
