Cat Paw Software

ユーザ用ツール

サイト用ツール

トレース:
rust:chrono

差分

このページの2つのバージョン間の差分を表示します。

この比較画面へのリンク

次のリビジョン		前のリビジョン
rust:chrono [2022/07/05 02:24] – 作成 nullponrust:chrono [2023/02/22 08:27] (現在) – nullpon
行 1: 行 1:
-====== chrono ======+<markdown> 
 + 
 +# Chrono
  
 Rustで日付・時刻を扱うライブラリ、事実上スタンダードになっている。タイムゾーンを扱う場合はchrono-tzを使う Rustで日付・時刻を扱うライブラリ、事実上スタンダードになっている。タイムゾーンを扱う場合はchrono-tzを使う
行 5: 行 7:
  
  
-===== 設定 =====+## 設定
  
 Cargo.tomlに追加 Cargo.tomlに追加
行 15: 行 17:
 ``` ```
  
-===== 現在日時の取得 =====+ 
 +## 現在日時の取得
  
 ローカルタイムゾーンで現在日時を取得 ローカルタイムゾーンで現在日時を取得
行 26: 行 29:
 ``` ```
  
-ローカルタイムゾーンで指定した日時を取得。ymd, and_hmsを使うときは`chrono::TimeZone`を読み込む 
  
-```+## 指定時刻の取得 
 + 
 +年月日時分秒を指定してDateTimeを取得 
 + 
 +```rust
 use chrono::{Local, TimeZone}; use chrono::{Local, TimeZone};
  
-let dt = Local.ymd(2022, 7, 5).and_hms(10, 14, 31); +let result = Local.with_ymd_and_hms(2022, 7, 5, 10, 14, 31);
-println!("{}", dt);+
 ``` ```
 +
 +`use chrono::TimeZone` が必要なことに注意。また、取得されるのはDateTimeではなく、`LocalResult<Option<DateTime>>` である
 +
 +日付が正しい場合は`single`が`Some<DateTime>`を返す
 +
 +```rust
 +let dt = Local.with_ymd_and_hms(2022, 7, 5, 10, 14, 31).single();
 +println!("{}", dt.unwrap());  // 2022-07-05 10:14:31 +09:00
 +```
 +
 +日付指定が不正な場合や、日付が１通りに定まらない場合、`single`は`None`を返す
 +
 +```rust
 +let dt = Local.with_ymd_and_hms(2022, 7, 5, 90, 14, 31).single();
 +println!("{}", dt.is_none());  // true
 +```
 +
 +アメリカ東海岸では夏時間の終了によって2023年11月5日1時30分という日時が2回発生するため１通りに定まらない
 +
 +```rust
 +let dt = chrono_tz::America::New_York.with_ymd_and_hms(2023, 11, 5, 1, 30, 0).single();
 +println!("{}", dt.is_none());  // true
 +```
 +
 +このような場合は`single`ではなく`earliest`、`latest`というメソッドでそれぞれの日時を取得できる
 +
 +```rust
 +let result = chrono_tz::America::New_York.with_ymd_and_hms(2023, 11, 5, 1, 30, 0);
 +
 +println!("{}", result.earliest().unwrap()); // 2023-11-05 01:30:00 EDT
 +println!("{}", result.latest().unwrap());   // 2023-11-05 01:30:00 EST
 +```
 +
 +matchで切り分けも可能
 +
 +```rust
 +let result = Local.with_ymd_and_hms(2022, 7, 5, 10, 14, 31);
 +match result {
 +    LocalResult::Single(dt) => println!("{}", dt),   
 +    LocalResult::Ambiguous(dt1, dt2) => println!("{} {}", dt1, dt2),
 +    LocalResult::None => println!("invalid date")
 +}
 +```
 +
 +ちなみに過去の日本でもGHQ占領下でサマータイム制が施行されている(1948〜1951年)
 +
 +```
 +let result = chrono_tz::Asia::Tokyo.with_ymd_and_hms(1951, 5, 6, 0, 30, 0);
 +match result {
 +    LocalResult::Single(dt) => println!("{}", dt),
 +    LocalResult::Ambiguous(dt1, dt2) => println!("{} {}", dt1, dt2),
 +    LocalResult::None => println!("invalid date")
 +}
 +
 +let result = chrono_tz::Asia::Tokyo.with_ymd_and_hms(1951, 9, 9, 0, 30, 0);
 +match result {
 +    LocalResult::Single(dt) => println!("{}", dt),
 +    LocalResult::Ambiguous(dt1, dt2) => println!("{} {}", dt1, dt2),
 +    LocalResult::None => println!("invalid date")
 +}
 +```
 +
 +```
 +invalid date
 +1951-09-09 00:30:00 JDT 1951-09-09 00:30:00 JST
 +```
 +
 +
 +</markdown>
rust/chrono.1656987871.txt.gz · 最終更新: 2022/07/05 02:24 by nullpon