Dateと日付のフォーマットIntl.DateTimeFormatの使い方
JavaScriptのDateオブジェクトの落とし穴(月は0始まり、タイムゾーン)と、Intl.DateTimeFormatで日本語の日付を整形する方法を実行結果つきで解説。日数計算や月末の求め方も紹介します。
この記事の目次
Dateと日付のフォーマットとは
JavaScriptで日付を扱う標準の仕組みは Date オブジェクトで、表示の整形には Intl.DateTimeFormat(または toLocaleDateString など)を使います。外部ライブラリがなくても、日本語の「2026年10月7日水曜日」や「令和8年」のような表示ができます。一方で Date には、月が0始まり、タイムゾーンの扱い、パース結果が環境で異なるなど、つまずきやすい点が多くあります。
基本(構文・仕組み)
const now = new Date(); // 現在時刻
const d1 = new Date(2026, 9, 6); // 2026年10月6日(月は0始まり)
const d2 = new Date('2026-10-06'); // ISO形式の文字列
const t = d1.getTime(); // エポックからのミリ秒
| 取得メソッド | 内容 |
|---|---|
getFullYear() |
年 |
getMonth() |
月(0〜11) |
getDate() |
日(1〜31) |
getDay() |
曜日(0=日曜) |
getTime() |
ミリ秒 |
toISOString() |
UTC基準のISO 8601文字列 |
サンプルコード(実行結果つき)
月は0始まり、月またぎの繰り上がり
console.log(new Date(2026, 11, 25).getMonth()); // 11(12月)
const d = new Date(2026, 0, 31);
d.setMonth(1); // 2月31日 → 3月3日に繰り上がる
console.log(d.getMonth(), d.getDate()); // 2 3
月末日の求め方
console.log(new Date(2026, 2, 0).getDate()); // 28(2026年2月)
console.log(new Date(2024, 2, 0).getDate()); // 29(うるう年)
console.log(new Date(2026, 0, 0).getDate()); // 31(前年12月)
日に 0 を指定すると「前月の最終日」になります。
日付のみの文字列はUTC扱い
console.log(new Date('2026-10-06').toISOString()); // 2026-10-06T00:00:00.000Z
console.log(new Date('2026-10-06T00:00:00').toISOString()); // 2026-10-05T15:00:00.000Z
日付だけの文字列はUTCの0時、時刻付き(Zなし)はローカル時間として解釈されます。日本(UTC+9)では、後者は9時間ずれた表示になります。
Intl.DateTimeFormatで整形
const t = new Date(Date.UTC(2026, 9, 6, 15, 30, 0)); // UTC 15:30 = 日本時間 翌日0:30
const f = (opt, loc = 'ja-JP') =>
new Intl.DateTimeFormat(loc, { timeZone: 'Asia/Tokyo', ...opt }).format(t);
console.log(f({ dateStyle: 'full', timeStyle: 'short' }));
// 2026年10月7日水曜日 0:30
console.log(f({ year: 'numeric', month: '2-digit', day: '2-digit' }));
// 2026/10/07
console.log(f({ weekday: 'short' }));
// 水
console.log(f({ dateStyle: 'long' }, 'ja-JP-u-ca-japanese'));
// 令和8年10月7日
console.log(new Intl.DateTimeFormat('en-US', { dateStyle: 'medium', timeZone: 'UTC' }).format(t));
// Oct 6, 2026
timeZone を指定すると、実行環境のタイムゾーンに左右されずに表示できます。ja-JP-u-ca-japanese で和暦になります。
相対表記と日数差
const rtf = new Intl.RelativeTimeFormat('ja', { numeric: 'auto' });
console.log(rtf.format(-1, 'day'), rtf.format(3, 'day')); // 昨日 3 日後
const a = new Date('2026-10-06'), b = new Date('2026-12-25');
console.log((b - a) / 86400000); // 80
日数差は、両方を同じ基準(ここではどちらもUTC)で作ってから引き算します。夏時間のある地域では、1日が24時間でない日がある点に注意してください。
不正な日付
console.log(new Date('invalid').getTime(), String(new Date('invalid')));
// NaN Invalid Date
動作確認(検証環境と結果)
- 環境: Node.js v24.19.0(Windows 11、OSのタイムゾーンは Asia/Tokyo)
- すべて実行し、上記の出力と一致することを確認。30日後の計算(
setDate(getDate()+30))も2026-11-05T15:30:00.000Zを確認。 - 検証ログ:
C:Tempks2techtestsjs-date-intl.md - 表示結果はOS・ブラウザ・ICUのバージョンで細部(空白や表記)が変わる可能性があります。ブラウザでの実行は未検証です。
Dateと日付のフォーマットの注意点
- 日付文字列のパースは、ISO 8601 形式(
YYYY-MM-DDTHH:mm:ss)以外は実装依存です。'2026/10/06'のような形式は避けるか、年月日を数値で渡す方が確実です。 - 結果はユーザーのタイムゾーンで変わります。サーバーとの受け渡しはUTC(ISO文字列)にそろえると安全です。
Dateはミュータブル(破壊的に変更できる)です。計算前にコピーを作ってください。- 大規模な日付処理には、今後の標準
Temporalや専用ライブラリの検討も選択肢ですが、対応状況は最新を確認してください。
Dateと日付のフォーマットでよくあるミス
getMonth()に1を足し忘れて、1か月ずれて表示する。getYear()を使う(非推奨。getFullYear()を使う)。- 日付だけの文字列で作った
Dateを、ローカル日付として扱って1日ずれる。 toLocaleStringの出力を文字列処理でパースする。
ブラウザ対応・バージョン
Intl.DateTimeFormat は現行の主要ブラウザで利用できます。dateStyle・timeStyle や Intl.RelativeTimeFormat は比較的新しいため、必要なバージョンは MDN の互換性表で確認してください。
Dateと日付のフォーマットのチェックリスト
- 月が0始まりであることを考慮した
- タイムゾーンの前提(UTC/日本時間)を決めた
- 日付文字列はISO形式を使った
- 表示は
Intl.DateTimeFormatで整形した - 不正な日付(NaN)の判定を入れた
Dateと日付のフォーマットのFAQ(よくある質問)
Q. 「2026-10-06 12:00」のような書式に整形するには?
A. Intl.DateTimeFormat の出力は区切り文字がロケールに依存します。固定書式にしたい場合は、getFullYear() などを取り出して padStart で組み立てる方が確実です。
Q. 日付の比較はどうしますか?
A. getTime() でミリ秒にして比較します。== ではオブジェクトの参照比較になります(等価演算子(==と===))。
Q. moment.js などは必要?
A. 簡単な整形と計算なら標準の機能で足ります。複雑な処理が多い場合に、軽量なライブラリを検討してください。
筆者の見解(Dateと日付のフォーマット)
日付の不具合は、コードそのものより「どのタイムゾーンで考えているか」が曖昧なことから起きると考えます。私見では、保存と受け渡しはUTCのISO文字列、表示のときだけ Intl.DateTimeFormat で timeZone を指定する、というルールを最初に決めておくのが最も確実です。
PR SkillHacks
ウェブ制作の次の一歩を、動画講座で自分のペースで進められます
独学のまま詰まって、制作の勉強が止まってしまう前に
こんなお悩みはありませんか?
- HTMLとCSSは分かったが、アプリや仕事の受注までの道筋が見えない
- 独学で詰まったとき、聞ける相手がいない
- スクールは高額で、続けられるか不安
プログラミングの独学は、エラーで進めなくなったときに聞く相手がいないと、そのまま止まりがちです。始める前に、質問できる時間帯と方法、受講期間、料金を確認しておくと選びやすくなります。
Programming Hacks(旧Skill Hacks)は、94本以上の動画で基礎からツール・アプリ作成、仕事の受注まで学べる買い切りのオンライン講座です。目安は1日2時間で2か月。質問は24時間LINEで送れます。
選ばれるポイント
- 仕事の受注まで見通せる。基礎からツール・アプリ作成、仕事の受注までを一つの講座で学べる
- 自分の時間割で進められる。動画講義が94本以上あり、目安は1日2時間で2か月
- 期限を気にせず学べる。受講期間は無制限で、修了後の再受講もでき、会員サイトは永久ログイン
- 詰まっても止まりにくい。24時間LINEで質問でき、サポートは無制限に延長と案内されている
- 追加費用を気にせず続けやすい。買い切り型で、料金は公式サイトに記載。支払いはクレジットカード・PayPal・銀行振込
- 講座の中身を確認してから決められる。運営は株式会社スキルハックス。申込前に特定商取引法の表記と最新の料金を公式サイトで確認する
買い切り型で、受講期間の期限はありません。申込前に講座の内容を公式サイトで確認できます
Programming Hacksの講座ページを開きます
【PR】この枠は広告(アフィリエイト)を含みます。内容は2026年11月15日時点の公式サイトの記載です。料金・サポート範囲・返金の可否は変わることがあるため、申込前に公式サイトと特定商取引法の表記で最新の条件をご確認ください。
Dateと日付のフォーマットの関連項目
出典(一次情報)
本記事は情報提供を目的としています。ブラウザの仕様やライブラリのバージョンによって動作が異なる場合があるため、実際の開発では公式ドキュメントも合わせてご確認ください。
