3行まとめ

.NETで、ISO 8601の週番号を扱いたい場合、ISOWeekクラスを使えばOK
ISOWeekクラスには、.NET 10で、DateOnlyのメソッド・オーバーロードが追加予定
.NET 9において、週番号に対応した書式指定子はない。.NET 10 preview 1段階でもなさそう

※ 本投稿では、「ISO 8601」の週に関してのみを対象とします。
※ 本投稿は、明記しない場合.NET 9時点の情報について基づいて作成しています。
※ 本投稿は、一部.NET 10 Preview 1の情報を含みます。正式リリース前に変更の可能性がある点に注意してください。

前提

ISO 8601は、日付、時刻、継続時間を規定する国際規格です。

このISO 8601の中で、「その年の第何週」というものが定められています。

週の開始曜日は、月曜日
その年の第1週は、その年の最初の木曜日を含む週です

2020年の年末・2021年の年始のカレンダーの一部は、次のような感じです。
2021年の1月1日・2日・3日は、2021年ですが「前年である2020年の第53週」に属していることに注目してください。

年と週	月	火	水	木	金	土	日
2020年第53週	12/28	12/29	12/30	12/31	1/1	1/2	1/3
2021年第1週	1/4	1/5	1/6	1/7	1/8	1/9	1/10

2014年の年末・2015年の年始のカレンダーの一部は、次のような感じです。
2014年の12月29日・30日・31日は、2014年ですが「翌年である2015年の第1週」に属していることに注目してください。

年と週	月	火	水	木	金	土	日
2014年第52週	12/22	12/23	12/24	12/25	12/26	12/27	12/28
2015年第1週	12/29	12/30	12/31	1/1	1/2	1/3	1/4

こんな感じで「その年の第何週」という概念、週番号があります。

ISOWeekクラスを使って週番号や年を求める

.NETのISOWeekクラスは、DateTime型に対してISO 8601の週番号を求めるGetWeekOfYearメソッドなどが定義されているクラスです。次にISOWeekクラスを使って、「〇〇年第XX週」のように表示するためのコードを示します。

DateTime date = DateTime.Parse("2021-01-01");

// 「2020年 第53週」と出力される
// 週番号を求めるには、GetWeekOfYearメソッドを使う
// その週の属する年を求めるときは、ISOWeek.GetYearメソッドを使うことに注意
Console.WriteLine(date.ToString($"{ISOWeek.GetYear(date)}年 第{ISOWeek.GetWeekOfYear(date)}週"));

DateTime型に対してISO 8601の週を求めて、「〇〇年第XX週」と表示する時は、「年」にも注意してください。Yearプロパティーを使って表示すると不具合を生んでしまいます。ISOWeekクラスのGetYearメソッドを使いましょう。

先に示した通り2021年1月1日は、2021年でありながら、前年である2020年の第53週に属しています。そのため、Yearプロパティーを使った次のようなコードでは、期待した「2020年第53週」という出力をしてくれず、「2021年第53週」と出力してしまいます。

DateTime date = DateTime.Parse("2021-01-01");

// 次のコードは間違い
// 「2021年 第53週」と出力されてしまう
// 2021年1月1日は、2020年の第53週なので間違い
Console.WriteLine(date.ToString($"{date.Year}年 第{ISOWeek.GetWeekOfYear(date)}週"));

ISOWeekクラスにはこれ以外にも、週関連の便利なメソッドが定義されています。

.NET 10で、DateOnly関連のオーバーロード・メソッドが加わりそう

※ 本節は、.NET 10 Preview 1の情報に基づいています。.NET 10の正式リリース前に変わる可能性がある点に注意してください。

.NET 10で、ISOWeekクラスに、DateOnly構造体を引数に取るオーバーロードとメソッドが加わる予定です。

DateOnly構造体は、.NET 6で追加されました。ISOWeekクラスは、.NET Core 3.0で追加されたクラスであり、登場時点でDateOnly構造体はまだなかったため、.NET 10での対応になったようです。

前節で紹介した

の引数としてDateTimeではなく、DateOnlyを引数に取るオーバーロードが追加される予定です。（確かにこのメソッド、意味的には時刻を司るDateTimeじゃなくて、日付を司るDateOnlyを引数に取る方が適切な気がしますね。）

DateOnly date = DateOnly.Parse("2021-01-01");
// 2021年 第53週
Console.WriteLine(date.ToString($"{ISOWeek.GetYear(date)}年 第{ISOWeek.GetWeekOfYear(date)}週"));

ISOWeekには、年・週番号・曜日を引数に取り、DateTime型を返す「ISOWeek.ToDateTime」メソッドがあります。

これとよく似たDateOnlyを返すメソッド「ISOWeek.ToDateOnly」が追加予定です。

DateTime dateTime = ISOWeek.ToDateTime(year: 2020,  week: 53, dayOfWeek: DayOfWeek.Friday);
// 2021/01/01 0:00:00
Console.WriteLine(dateTime);

DateOnly dateOnly = ISOWeek.ToDateOnly(year: 2020,  week: 53, dayOfWeek: DayOfWeek.Friday);
// 2021/01/01 0:00:00
Console.WriteLine(dateOnly);

週番号に対応した書式指定子はない

.NET 9において、週番号に対応した書式指定子はなさそうです。

.NET 10 Preview 1でも、コード見る限りはぱっと見なさそう。

（書式指定子って、後から足せるんだろうか？足したら破壊的な変更になるから、難しい？）

まとめ

.NETで、ISO 8601の週番号を扱いたい場合、ISOWeekクラスを使えばOK
ISOWeekクラスには、.NET 10で、DateOnlyのメソッド・オーバーロードが追加予定
.NET 9において、週番号に対応した書式指定子はない。.NET 10 preview 1段階でもなさそう