DateTimeのKind

DateTimeが持つUtc/Local/Unspecifiedの3値の属性。既定はUnspecifiedで、変換メソッドがどちらの基準とみなすかが呼び出し先ごとに異なる。

概念URI

https://comcomponent.com/knowledge/datetime-kind/

別名・表記

Kind属性 / DateTimeKind / Unspecified

最終確認日

2026-08-01

機械可読データ

JSON-LD

この概念が関わる関係

• DateTimeのKindはサーバー移設時の9時間ずれ事故の原因になることがあります。Kindが既定でUnspecifiedの値にToLocalTime/ToUniversalTimeを適用すると実行マシンのタイムゾーン設定に依存した黙った変換が起こり、9時間ずれ事故の典型的な発生源になる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• TimeZoneInfoはDateTimeのKindを前提とします。TimeZoneInfo.ConvertTimeなどDateTimeを受け取る変換APIを使う場合、そのAPIはDateTimeのKindと変換元タイムゾーンの整合を検査し、不一致だとArgumentExceptionになる。DateTimeOffsetを受け取るオーバーロードにはKindが無く、この検査も働かない / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• EF Coreの値コンバーターはDateTimeのKindを利用します。EF Coreの値コンバーターはUTC以外の値を境界で正規化し、読み出し時にKindをUtcへ復元することでKindの扱いを一括宣言する / 確度: 確立した関係 / 確認日: 2026-08-01 出典

この概念を扱う記事

• 業務アプリの日時とタイムゾーン ── DateTimeの罠からUTC保存の原則、テスト設計まで(主要トピック)

一次資料

• https://learn.microsoft.com/dotnet/api/system.datetime.kind

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。