Begynn med torsdag

I ISO-systemet går uka fra mandag til søndag. Uke 1 er uka som inneholder 4. januar, eller årets første torsdag. En praktisk måte å finne ukeåret på er derfor å flytte datoen til torsdagen i samme uke. Året til denne torsdagen er ukeåret.

function isoWeek(dateText) {
  const date = new Date(dateText + 'T00:00:00Z');
  if (Number.isNaN(date.getTime())) throw new Error('Ugyldig dato');
  const weekday = date.getUTCDay() || 7;
  date.setUTCDate(date.getUTCDate() + 4 - weekday);
  const year = date.getUTCFullYear();
  const firstDay = new Date(Date.UTC(year, 0, 1));
  const week = Math.ceil((((date - firstDay) / 86400000) + 1) / 7);
  return { year, week };
}

console.log(isoWeek('2027-01-01')); // { year: 2026, week: 53 }
console.log(isoWeek('2027-01-04')); // { year: 2027, week: 1 }

UTC brukes her for å behandle en ren datoverdi uten at maskinens lokale tidssone endrer hvilken dato beregningen tar utgangspunkt i. Eksemplet er avgrenset til en gyldig dato på formen ÅÅÅÅ-MM-DD; en produksjonsløsning bør også kontrollere at inndata faktisk er den kalenderdatoen brukeren skrev.

Vis datoene sammen med uken

En leser som ser «uke 53» trenger gjerne mandagens og søndagens dato. Ved årsskiftet er det også nyttig å skrive ukeåret uttrykkelig. Fredag 1. januar 2027 tilhører intervallet mandag 28. desember 2026 til søndag 3. januar 2027. Å lese kalenderåret som ukeåret ville gitt feil etikett.

Det finnes mange ferdige datobiblioteker. Poenget her er å gjøre datamodellen tydelig: dato, uke og ukeår er tre opplysninger. Det er verdt å ha egne sjekker for de siste dagene i desember og de første dagene i januar.

Se Dagsblikks ukenummeroversikt for den redaksjonelle presentasjonen. Om Dagsblikk forklarer publikasjonen og arbeidsmåten. Jonas Bjarne Nilsen Hansen er skribent og redaktør; rettelser kan sendes til info@dagsblikk.com.