ホーム / Date/Time / ナノ秒精度のInstant
Date/Time 中級

ナノ秒精度のInstant

マイクロ秒またはナノ秒精度でタイムスタンプを取得する。

コード比較
✕ Java 8 
// Millisecond precision only
long millis =
    System.currentTimeMillis();
// 1708012345678
✓ Java 9+ 
// Microsecond/nanosecond precision
Instant now = Instant.now();
// 2025-02-15T20:12:25.678901234Z
long nanos = now.getNano();
このコードに問題がありますか？ お知らせください。
モダンな方法が優れている理由
🎯

より高い精度

ミリ秒ではなくマイクロ秒・ナノ秒単位のタイムスタンプ。

📐

型安全

Instantは精度を内包するため、意味が曖昧なlongを使いません。

🌐

UTCベース

InstantはUTCに固定されており、タイムゾーンの混乱がありません。

旧来のアプローチ
ミリ秒
モダンなアプローチ
ナノ秒
JDKバージョン
9
難易度
中級
JDKサポート
ナノ秒精度のInstant
利用可能

JDK 9（2017年9月）以降、広く利用可能

仕組み

Java 9ではクロック解像度が改善され、Instant.now()はほとんどのプラットフォームでマイクロ秒精度（一部ではナノ秒）のタイムスタンプを取得できます。従来のcurrentTimeMillis()はミリ秒精度しかありませんでした。

関連ドキュメント
Instant ↗ Clock ↗
関連パターン
Date/Time 中級

HexFormat

Java 8
// Pad to 2 digits, uppercase
String hex = String.format(
    "%02X", byteValue);
// Parse hex string
int val = Integer.parseInt(
    "FF", 16);
Java 17+
var hex = HexFormat.of()
    .withUpperCase();
String s = hex.toHexDigits(
    byteValue);
byte[] bytes =
    hex.parseHex("48656C6C6F");
ホバーしてモダンを見る ➜
JDK 17+ →
Date/Time 初級

java.time API basics

Pre-Java 8
// Mutable, confusing, zero-indexed months
Calendar cal = Calendar.getInstance();
cal.set(2025, 0, 15); // January = 0!
Date date = cal.getTime();
// not thread-safe
Java 8+
LocalDate date = LocalDate.of(
    2025, Month.JANUARY, 15);
LocalTime time = LocalTime.of(14, 30);
Instant now = Instant.now();
// immutable, thread-safe
ホバーしてモダンを見る ➜
JDK 8+ →
Date/Time 初級

Duration and Period

Pre-Java 8
// How many days between two dates?
long diff = date2.getTime()
    - date1.getTime();
long days = diff
    / (1000 * 60 * 60 * 24);
// ignores DST, leap seconds
Java 8+
long days = ChronoUnit.DAYS
    .between(date1, date2);
Period period = Period.between(
    date1, date2);
Duration elapsed = Duration.between(
    time1, time2);
ホバーしてモダンを見る ➜
JDK 8+ →
共有 𝕏 🦋 in ⬡