定石1: DateTime.Kindの3つの罠（Local / Utc / Unspecified）

出典: C# DateTime と DateTimeOffset の違い・タイムゾーン処理の正解（業務SE本番事故編） — 定石1: DateTime.Kindの3つの罠（Local / Utc / Unspecified）

定石1: DateTime.Kindの3つの罠（Local / Utc / Unspecified） (csharp)#05c39f91324d

// ✅定石1: DateTime.Kindの3パターン
var local = DateTime.Now;                                  // Kind=Local
var utc   = DateTime.UtcNow;                                // Kind=Utc
var unsp  = new DateTime(2026, 5, 8, 14, 30, 0);            // Kind=Unspecified
 
Console.WriteLine($"Local: {local.Kind}");      // Local
Console.WriteLine($"Utc  : {utc.Kind}");        // Utc
Console.WriteLine($"Unsp : {unsp.Kind}");       // Unspecified
 
// ❌罠: UnspecifiedをToUniversalTime()するとLocalとみなされる
var converted = unsp.ToUniversalTime();         //内部でLocalとみなして変換
Console.WriteLine($"Converted: {converted}");   // JST環境なら-9時間されてる
 
// ✅正しい書き方:明示的にKindを指定
var jstUnsp = DateTime.SpecifyKind(unsp, DateTimeKind.Local);
var jstUtc  = jstUnsp.ToUniversalTime();        //期待通りの変換

▸ 実行ボタンで結果を表示

id: #05c39f91324d
lines: 16
extracted: 2026-06-10
captured: 2026-06-04

Source収録記事

この snippet は記事の「定石1: DateTime.Kindの3つの罠（Local / Utc / Unspecified）」セクションに登場する。コードの前後の文脈・ハマりどころの解説は記事本文で。

技術記事.NET FrameworkC#

C# DateTime と DateTimeOffset の違い・タイムゾーン処理の正解（業務SE本番事故編）

1ヶ月前20 min

同じ記事から

6 件

// ✅定石2:サーバー処理はUtcNow、UI表示だけNow
public class OrderLog
{
    public Guid OrderId { get; set; }

未収録

定石2: DateTime.NowとDateTime.UtcNowの使い分け

#23a7f94f1fd9

// ✅定石3: DateTimeOffsetでタイムゾーン情報を持ち回る
DateTimeOffset jstNow = DateTimeOffset.Now;             // JST環境なら+09:00
DateTimeOffset utcNow = DateTimeOffset.UtcNow;          // +00:00

▶ 実行可

定石3: DateTimeOffsetを使うべき場面

#ec04c241b5a6

// ✅定石4: TimeZoneInfoで明示的タイムゾーン変換
var utcNow = DateTime.UtcNow;

// JSTに変換（.NET Framework / Windows: "Tokyo Standard Time"）

▶ 実行可

定石4: TimeZoneInfo.ConvertTimeで明示的タイムゾーン変換

#0a3109479ee8

SQL

-- ✅定石5-a: datetimeとdatetime2の精度差
DECLARE @dt1 datetime  = '2026-05-08 14:30:00.123';
DECLARE @dt2 datetime2 = '2026-05-08 14:30:00.123';

▶ 実行可

定石5: SQL Server datetime vs datetime2 —業務系JOIN事故の温床

#b343acd30a08

// ✅定石5-b: SQL Serverから読み出したDateTimeのKindはUnspecified
using (var conn = new SqlConnection(connStr))
using (var cmd = new SqlCommand("SELECT created_at FROM order_log WHERE id = @id", conn))
{

▶ 実行可

定石5: SQL Server datetime vs datetime2 —業務系JOIN事故の温床

#b11995d138a9

// ✅定石6: JSONシリアライズでKindを死守する
using Newtonsoft.Json;
using Newtonsoft.Json.Converters;

未収録

定石6: JSONシリアライズでISO 8601統一

#bd2c0847de10

図鑑トップ