JavaScript Temporali kestuse aritmeetika meisterlikkus: globaalne juhend ajaintervallide matemaatikasse

            const twoYearsThreeMonths = Temporal.Duration.from({
  years: 2,
  months: 3
});

console.log(twoYearsThreeMonths);
// Temporal.Duration { years: 2, months: 3, ... }

const oneDayEightHours = Temporal.Duration.from({
  days: 1,
  hours: 8,
  minutes: 30
});

console.log(oneDayEightHours);
// Temporal.Duration { days: 1, hours: 8, minutes: 30, ... }

const negativeDuration = Temporal.Duration.from({
  hours: -5,
  minutes: -15
});

console.log(negativeDuration);
// Temporal.Duration { hours: -5, minutes: -15, ... }

            

              
                Copy
              
            
          

            const isoDuration1 = Temporal.Duration.from('P1Y2M3DT4H5M6S');
console.log(isoDuration1);
// Temporal.Duration { years: 1, months: 2, days: 3, hours: 4, minutes: 5, seconds: 6, ... }

const isoDuration2 = Temporal.Duration.from('P10DT5H'); // 10 päeva, 5 tundi
console.log(isoDuration2);
// Temporal.Duration { days: 10, hours: 5, ... }

const isoDuration3 = Temporal.Duration.from('P3M'); // 3 kuud
console.log(isoDuration3);
// Temporal.Duration { months: 3, ... }

// Vigased ISO 8601 stringid põhjustavad vea.
// Temporal.Duration.from('PT10M5S'); // See on kehtiv
// Temporal.Duration.from('10M'); // See ei ole kehtiv ilma 'P'-ta

            

              
                Copy
              
            
          

            const constructorDuration = new Temporal.Duration(0, 0, 0, 1, 2, 3); // aastad, kuud, nädalad, päevad, tunnid, minutid
console.log(constructorDuration);
// Temporal.Duration { years: 0, months: 0, weeks: 0, days: 1, hours: 2, minutes: 3, ... }

// Märkus: Konstruktor võtab argumente kindlas järjekorras (aastad, kuud, nädalad, päevad, tunnid, minutid, sekundid, millisekundid, mikrosekundid, nanosekundid).
// Vähemate argumentide esitamine tähendab, et hilisemad ühikud loetakse nulliks.
const partialDuration = new Temporal.Duration(1, 6); // 1 aasta, 6 kuud
console.log(partialDuration);
// Temporal.Duration { years: 1, months: 6, ... }

            

              
                Copy
              
            
          

            const myDuration = Temporal.Duration.from({
  years: 5,
  days: 10,
  hours: 12,
  minutes: 45
});

console.log(myDuration.years);
// 5
console.log(myDuration.days);
// 10
console.log(myDuration.hours);
// 12
console.log(myDuration.minutes);
// 45
console.log(myDuration.seconds); // Määramata ühikud on 0
// 0

            

              
                Copy
              
            
          

            const duration1 = Temporal.Duration.from({ days: 10, hours: 5 });
const duration2 = Temporal.Duration.from({ days: 5, hours: 10 });

const totalDuration = duration1.add(duration2);
console.log(totalDuration);
// Temporal.Duration { days: 15, hours: 15, ... }

const duration3 = Temporal.Duration.from({ years: 1, months: 6 });
const duration4 = Temporal.Duration.from({ months: 8, days: 15 });

const combinedDuration = duration3.add(duration4);
console.log(combinedDuration);
// Temporal.Duration { years: 1, months: 14, days: 15, ... }
// Märkus: See on lihtne summeerimine. Temporal tegeleb ühikute ülekandmisega (nt 14 kuud muutub 1 aastaks ja 2 kuuks) PlainDate/Time objektidega suheldes.

// Negatiivse kestuse liitmine on samaväärne lahutamisega
const duration5 = Temporal.Duration.from({ hours: 3 });
const duration6 = Temporal.Duration.from({ hours: -1 });

const result = duration5.add(duration6);
console.log(result);
// Temporal.Duration { hours: 2, ... }

            

              
                Copy
              
            
          

            const durationA = Temporal.Duration.from({ days: 20, hours: 10 });
const durationB = Temporal.Duration.from({ days: 5, hours: 3 });

const remainingDuration = durationA.subtract(durationB);
console.log(remainingDuration);
// Temporal.Duration { days: 15, hours: 7, ... }

// Kestuse lahutamine, mille tulemuseks on negatiivne väärtus
const durationC = Temporal.Duration.from({ minutes: 30 });
const durationD = Temporal.Duration.from({ minutes: 45 });

const negativeResult = durationC.subtract(durationD);
console.log(negativeResult);
// Temporal.Duration { minutes: -15, ... }

            

              
                Copy
              
            
          

            const positiveDuration = Temporal.Duration.from({ hours: 10, minutes: 30 });
const negativeDuration = positiveDuration.negated();
console.log(negativeDuration);
// Temporal.Duration { hours: -10, minutes: -30, ... }

const alreadyNegative = Temporal.Duration.from({ days: -5 });
const nowPositive = alreadyNegative.negated();
console.log(nowPositive);
// Temporal.Duration { days: 5, ... }

            

              
                Copy
              
            
          

            const negativeDuration = Temporal.Duration.from({ hours: -8, minutes: -20 });
const absoluteDuration = negativeDuration.abs();
console.log(absoluteDuration);
// Temporal.Duration { hours: 8, minutes: 20, ... }

            

              
                Copy
              
            
          

            const dailyDuration = Temporal.Duration.from({ days: 1 });
const twoWeeks = dailyDuration.multiply(14);
console.log(twoWeeks);
// Temporal.Duration { days: 14, ... }

const hourlyIncrement = Temporal.Duration.from({ hours: 1 });
const workWeek = hourlyIncrement.multiply(40);
console.log(workWeek);
// Temporal.Duration { hours: 40, ... }

const projectPhase = Temporal.Duration.from({ months: 2 });
const fullProject = projectPhase.multiply(3);
console.log(fullProject);
// Temporal.Duration { months: 6, ... }

// Korrutamist saab teha ka negatiivsete arvudega
const futureEvent = Temporal.Duration.from({ days: 5 }).multiply(-2);
console.log(futureEvent);
// Temporal.Duration { days: -10, ... }

            

              
                Copy
              
            
          

            const totalWorkTime = Temporal.Duration.from({ hours: 40, minutes: 30 });
const timePerTask = totalWorkTime.divide(5);
console.log(timePerTask);
// Temporal.Duration { hours: 8, minutes: 1, ... } // 40,5 tundi / 5 = 8,1 tundi. 0,1 tundi (6 minutit) kärbitakse.

const projectDuration = Temporal.Duration.from({ days: 90 });
const phaseDuration = projectDuration.divide(3);
console.log(phaseDuration);
// Temporal.Duration { days: 30, ... }

// Jagamine negatiivse arvuga
const longDuration = Temporal.Duration.from({ years: 2 }).divide(-4);
console.log(longDuration);
// Temporal.Duration { years: -0, ... } // -0,5 aastat annab kärpimise tõttu tulemuseks 0 aastat.
// Täpsemate arvutuste jaoks, mis hõlmavad jagamist ja murdosi, kaaluge meetodite kasutamist, mis töötavad Temporal.Instant või Temporal.PlainDateTime'iga.

            

              
                Copy
              
            
          

            const impreciseDuration = Temporal.Duration.from({
  hours: 2,
  minutes: 35,
  seconds: 45
});

// Ümardamine lähima minutini, kasutades halfExpand'i (standardne ümardamine)
const roundedToMinute = impreciseDuration.round('minute', Temporal.RoundingMode.halfExpand);
console.log(roundedToMinute);
// Temporal.Duration { hours: 2, minutes: 36, ... } // 35 minutit ja 45 sekundit ümardatakse 36 minutiks

// Kärpimine lähima tunnini
const truncatedToHour = impreciseDuration.round('hour', Temporal.RoundingMode.trunc);
console.log(truncatedToHour);
// Temporal.Duration { hours: 2, ... } // Eemaldab minutid ja sekundid.

// Ümardamine ülespoole lähima tunnini
const ceiledToHour = impreciseDuration.round('hour', Temporal.RoundingMode.ceil);
console.log(ceiledToHour);
// Temporal.Duration { hours: 3, ... } // Kuna on olemas minutid ja sekundid, ümardatakse ülespoole.

// Ümardamine väiksema ühikuni (nt sekunditeni) võib paljastada rohkem täpsust
const preciseRounding = impreciseDuration.round('second', Temporal.RoundingMode.halfExpand);
console.log(preciseRounding);
// Temporal.Duration { hours: 2, minutes: 35, seconds: 45, ... }

            

              
                Copy
              
            
          

            const durationX = Temporal.Duration.from({ days: 1, hours: 12 }); // 1,5 päeva
const durationY = Temporal.Duration.from({ hours: 36 });     // 1,5 päeva
const durationZ = Temporal.Duration.from({ days: 2 });       // 2 päeva

console.log(Temporal.Duration.compare(durationX, durationY)); // 0 (võrdne)
console.log(Temporal.Duration.compare(durationX, durationZ)); // -1 (durationX on väiksem kui durationZ)
console.log(Temporal.Duration.compare(durationZ, durationY)); // 1 (durationZ on suurem kui durationY)

// Võrdlus negatiivsete kestustega
const negDuration1 = Temporal.Duration.from({ hours: -5 });
const negDuration2 = Temporal.Duration.from({ hours: -10 });

console.log(Temporal.Duration.compare(negDuration1, negDuration2)); // 1 (nt -5 on suurem kui -10)

            

              
                Copy
              
            
          

            // Näide, kasutades Temporal.PlainDate'i (nõuab polüfilli või natiivset tuge)
// Eeldades, et teie keskkonnas on olemas Temporal polüfill või natiivne tugi.

// Kujutame ette, et täna on 15. juuli 2024
const today = Temporal.PlainDate.from({ year: 2024, month: 7, day: 15 });

const durationToAdd = Temporal.Duration.from({ years: 1, months: 3, days: 15 });

const futureDate = today.add(durationToAdd);
console.log(futureDate);
// Temporal.PlainDate { year: 2025, month: 11, day: 1 }

// Globaalne näide: tulevase kuupäeva arvutamine, arvestades erineva pikkusega kuid
const londonDate = Temporal.PlainDate.from({ year: 2024, month: 1, day: 31 }); // 31. jaanuar
const durationForNextMonth = Temporal.Duration.from({ months: 1 });

const nextMonthDate = londonDate.add(durationForNextMonth);
console.log(nextMonthDate);
// Temporal.PlainDate { year: 2024, month: 2, day: 29 } // Käsitleb korrektselt liigaastat ja kuu lõppu.

const newYorkDate = Temporal.ZonedDateTime.from({
  timeZone: 'America/New_York',
  year: 2024,
  month: 10,
  day: 28,
  hour: 10,
  minute: 0,
  second: 0
});

const travelDuration = Temporal.Duration.from({ hours: 8 }); // 8-tunnine lend

// Märkus: Kestuste liitmisel ZonedDateTime'ile on oluline arvestada ajavööndit.
// Tulemus on samas ajavööndis, kui pole teisiti määratud.
const arrivalTimeNY = newYorkDate.add(travelDuration);
console.log(arrivalTimeNY);
// Temporal.ZonedDateTime { year: 2024, month: 10, day: 28, hour: 18, minute: 0, second: 0, ... }

// Kui soovite arvutada saabumisaega TEISES ajavööndis, teeksite tavaliselt:
// 1. Liidate kestuse väljumise ZonedDateTime'ile.
// 2. Teisendate tulemuseks oleva ZonedDateTime'i sihtkoha ajavööndisse.
const tokyoTimeZone = 'Asia/Tokyo';
const arrivalTimeTokyo = arrivalTimeNY.withTimeZone(tokyoTimeZone);
console.log(arrivalTimeTokyo);
// Temporal.ZonedDateTime { year: 2024, month: 10, day: 29, hour: 7, minute: 0, second: 0, ... } (Märkus kuupäeva ja kellaaja muutuse kohta ajavööndi tõttu)

            

              
                Copy
              
            
          

            const startDate = Temporal.PlainDate.from({ year: 2023, month: 1, day: 1 });
const endDate = Temporal.PlainDate.from({ year: 2024, month: 3, day: 15 });

const elapsedDuration = startDate.until(endDate);
console.log(elapsedDuration);
// Temporal.Duration { years: 1, months: 2, days: 14, ... }

// Globaalne näide: lepingu pikkuse erinevuse arvutamine
const contractStart = Temporal.ZonedDateTime.from({
  timeZone: 'UTC',
  year: 2022,
  month: 5,
  day: 10,
  hour: 9,
  minute: 0
});

const contractEnd = Temporal.ZonedDateTime.from({
  timeZone: 'UTC',
  year: 2025,
  month: 8,
  day: 20,
  hour: 17,
  minute: 30
});

const contractLength = contractStart.until(contractEnd);
console.log(contractLength);
// Temporal.Duration { years: 3, months: 3, days: 10, hours: 8, minutes: 30, ... }

// Kasutades until/since ZonedDateTime'iga, võib tulemus olla keeruline ajavööndite ja suveaja tõttu.
// Temporal tegeleb sellega, andes teile kestuse, mis ei pruugi täiuslikult 'edasi-tagasi' toimida, kui te selle lihtsalt tagasi liidate ilma ajavööndit arvestamata.

            

              
                Copy