Reckonerで日付や日時のデータを操作・変換するためのタスク一覧と使い方ガイドです。
日付データの3つの型(データ型)
Reckonerでは、日付の値は次の3種類の型で扱われます。「元のデータがどの型か」「どの型に変換したいか」によって使用するタスクが異なります。
日付(date型): 日付情報のみを持つ値
例:2026-10-09日時(timestamp型): 日付と時刻(タイムゾーン含む)を持つ値
例:2026-10-09T03:00:00Z(末尾のZはUTC=協定世界時)文字列(string型): 日付の形をした単なるテキストデータ
例:2026/10/09,2026年10月9日
やりたいこと別 タスク早見表
| やりたいこと | 例(入力 → 出力) | 使うタスク |
|---|---|---|
| 日付・日時を、指定した表示形式の文字列にする | 2026-10-09 → 2026/10/09 / 20261009 | 日付変換 |
| 日時を、日本時間(JST)などのタイムゾーンに変換して表示する | 2026-10-09T03:00:00Z → 2026/10/09 12:00:00 | タイムスタンプ変換 |
| 文字列の日付を、日付(date型)データに変換する | "2026/10/09" → 日付(date型)の値 | 日付パース |
| 文字列の日時を、日時(timestamp型)データに変換する | "2026/10/09 12:00:00" → 日時(timestamp型)の値 | タイムスタンプパース |
| 西暦の日付・日時を和暦の文字列にする | 2026-10-09 → 令和8年10月9日 | 和暦西暦変換 |
和暦西暦変換を使う際の注意点
西暦→和暦のみ対応: 和暦から西暦への変換(逆変換)はできません。
入力可能な型: 日付(date型)または日時(timestamp型)のみです。文字列は入力できません。
出力表記: 月日は2桁固定(ゼロ埋め)となります。元号表記は「漢字(例:
令和8年10月09日)」か「アルファベット(例:R8 10月09日)」を選択可能です。日時(timestamp型)入力時: 日本時間に換算した時刻情報も付加されます(例:
令和8年10月09日 12:00:00 Asia/Tokyo)。
「日付変換」と「タイムスタンプ変換」の違い
日付変換:
date型・timestamp型の両方を入力できます。ただし、タイムゾーンの指定はできません。
※日時(timestamp型)を入力した際にエラーが発生する場合は、代わりに「タイムスタンプ変換」をご利用ください。タイムスタンプ変換:
timestamp型のみ入力可能です。出力のタイムゾーンを指定できます(初期値はAsia/Tokyo。空欄にした場合はUTCになります)。
注意(時差の発生について)
日本時間(JST)で出力したい場合は「タイムスタンプ変換」を使用し、タイムゾーンの設定がAsia/Tokyoになっていることを確認してください(初期値でAsia/Tokyoがセットされています)。タイムゾーンを消して空欄にするとUTC(協定世界時)で出力され、表示が9時間ずれます。
タイムスタンプパースのタイムゾーン設定
「タイムスタンプパース」にもタイムゾーンの設定オプションがあります(初期値は Asia/Tokyo)。
これは「入力された文字列を、どのタイムゾーンの時刻として読み取るか」の指定です。
例:
"2026/10/09 12:00:00"という文字列をAsia/Tokyoで読み取ると、2026-10-09T03:00:00Z(UTC換算)として正しく保持されます。設定を空欄にすると
UTCの時刻として読み取られてしまい、日本時間と比べて9時間のずれが発生するためご注意ください。
表示形式(フォーマット)の書き方 早見表
日付変換やタイムスタンプ変換でよく使うフォーマット記法です。大文字・小文字の区別に注意して設定してください。
| 記法 | 意味 | 2026-10-09 09:05:30 の場合の出力例 |
|---|---|---|
%Y | 年(4桁) | 2026 |
%m | 月(2桁・ゼロ埋め) | 10 |
%d | 日(2桁・ゼロ埋め) | 09 |
%H | 時(24時間制・2桁) | 09 |
%M | 分(2桁) | 05 |
%S | 秒(2桁) | 30 |
%F | %Y-%m-%d と同等 | 2026-10-09 |
よく使われる組み合わせ例:
スラッシュ区切り(例:
2026/10/09):%Y/%m/%d日本語表記(例:
2026年10月09日):%Y年%m月%d日8桁数値表記(例:
20261009):%Y%m%d
間違いやすいポイント
月の指定は小文字の%m、分の指定は大文字の%Mです。また、yyyy/MM/ddなどの表記はReckonerの標準指定では正しく読み込まれないため、必ず%(パーセント記号)を用いた記法に統一してください。