.NET Core(C#): DateTime日付・整数変換サンプル

はじめに

  • サンプルは.NET Core 3.1(Windows 10)で動作確認しています。
  • 型が分かりやすいよう変数宣言ではvarを使用していません。実装時はvarを使用することをおすすめします。
  • 完全なソースコードはこちらで公開しています。

システム日時・日付の取得

  • 日付・時刻を使用する場合はDateTime構造体を使用します。
  • なお、日本時間はUTCより9時間進んでいるので、UTC形式の日時は-9時間した値になります。

文字列・整数からのDateTime生成

  • DateTime型では0001/01/01~9999/12/31まで日時を指定できます。

DateTimeからの年月日・時分秒・曜日の取得

  • 曜日はDayOfWeek列挙体で保持されています。

DateTimeから日付・時刻文字列の生成

  • DateTime型の日時を文字列に変換する場合はDateTime.ToString()を使用します。
  • 引数で指定可能な書式は、大きく分けて「標準日時書式」「カスタム日時書式」があります。
    • 標準日時書式: 例えばISO 8601形式, RFC1123形式等のように一般的・標準的な日時書式を使用する場合に使用します。”O”, “R”等のように1文字で表現されます。
    • カスタム日時書式: “20210709”等のように独自の書式を指定する場合に使用します。”yyyy”, “HH”等のように日時の構成部分を表現する多様なパターンを指定できます。
      なお、MM/mm、HH/hh等のように大・小文字の違いで意味が大きく異なる場合があるので注意が必要です。MMは「月」でmmは「分」、HHは24時間表記の「時」でhhは12時間表記の「時」です。
  • 文字列から日付を使用する場合はDateTime.Parse(), DateTime.ParseExact()を使用できます。
  • 意図しない文字列の取り込み防止、仕様の単純化、性能改善のために、ParseExact()の使用をおすすめします。
    カルチャを意識しない場合は第3引数はnullで問題ありません。

    If provider is null, the CultureInfo object that corresponds to the current culture is used.

ゾーン情報とUTC時刻の取得

  • 既定では実行環境のタイムゾーンが使用されます。
  • DateTime型のプロパティ・メソッドを使用してUTC日時に変換することもできます。
    任意のタイムゾーンの日時に変換する場合、TimeZoneInfo.FindSystemTimeZoneById()を使用して該当するタイムゾーン情報を取得し、TimeZoneInfo.ConvertTime()で日時を変換できます。
  • FindSystemTimeZoneById()の引数では標準タイムゾーン名を指定します。指定可能なタイムゾーン名の一覧はこちらをご覧ください。

サポートするタイムゾーン一覧

こちらで紹介しています。

NDW

目次 1 はじめに2 標準タイムゾーン名一覧の取得方法3 標準タイムゾーン名一覧 はじめに サンプルは.NET Core…

Kindの設定

(更新中)

月末・月初の算出

  • DateTimeコンストラクタやAddMonths(), AddDays()等を使用して月末・月初の日時を生成できます。

日時の差分、経過時間の算出

  • DateTime型では演算子(演算子オーバーロード)が定義されているため、+-を使った日時演算や、>=<等を使った日時の大小比較が可能になっています。
  • 日時の差分はTimeSpan構造体で表現され、日/時/分/秒/ミリ秒を単位とする差分を保持します。
    2つの日時の差(日数や時間)を取得する場合は、基本的にTotalDays, TotalHours等のTotalが付くプロパティを使用します。

    Totalが付かないDays, Hours等は2つの日時の日や時間だけを見た場合の差分を返却します。
    例えば、下記サンプルにおける2つの日付の差分(時間)は約26時間程です。TotalHoursは約26になっており期待する値になっていますが、Hoursは2時間になっており期待する結果と大きく異なります。Hoursは単純に2つの日付の「時」部分の差(23-21)を算出しているためです。

経過時間の取得(秒、ミリ秒、マイクロ秒、ナノ秒)

こちらで紹介しています。

NDW

目次 1 はじめに2 経過時間測定のサンプル3 ElapsedTicksを使った経過時間の算出方法 はじめに 次の環境を…