MakeTimestamp logo
MakeTimestamp

タイムスタンプ資料

タイムスタンプ形式のチートシート: クイック リファレンス ガイド

概要

この包括的なチートシートは、プログラミングやデータ交換で使用されるすべての一般的なタイムスタンプ形式のクイック リファレンスを提供します。すべての例では、2024 年 1 月 1 日、12:00:00 UTC を基準時刻として使用します。

クイックリファレンステーブル

フォーマット例長さ使用例
Unix 秒170411040010桁レガシー システム、API
Unix ミリ秒170411040000013桁JavaScript、Java、最新の API
Unix マイクロ秒170411040000000016桁高精度ロギング
Unix ナノ秒170411040000000000019桁パフォーマンス監視
ISO 8601 (UTC)2024-01-01T12:00:00Z変数国際規格
ISO 8601 (タイムゾーン)2024-01-01T12:00:00+00:00変数タイムゾーンを意識したデータ
RFC 33392024-01-01T12:00:00.000Z変数インターネットのタイムスタンプ
RFC 2822Mon, 01 Jan 2024 12:00:00 +0000変数電子メールのヘッダー
SQL 日時2024-01-01 12:00:0019文字データベースストレージ

Unix タイムスタンプ形式

秒 (10 桁)

形式: 1970 年 1 月 1 日 00:00:00 UTC からの秒数を表す整数

1704110400

使用する場合:

  • レガシーシステムとAPI
  • ストレージ効率 (int32 として 4 バイト)
  • 2038年問題の考察

コード例:

// JavaScript
const timestamp = Math.floor(Date.now() / 1000);
// 1704110400

const date = new Date(timestamp * 1000);
// 2024-01-01T12:00:00.000Z

# Python
import time
timestamp = int(time.time())
# 1704110400

from datetime import datetime
date = datetime.fromtimestamp(timestamp)
# 2024-01-01 12:00:00

// PHP
$timestamp = time();
// 1704110400

$date = date('Y-m-d H:i:s', $timestamp);
// 2024-01-01 12:00:00

// Go
import "time"

timestamp := time.Now().Unix()
// 1704110400

date := time.Unix(timestamp, 0)
// 2024-01-01 12:00:00 +0000 UTC

ミリ秒 (13 桁)

形式: Unix エポックからのミリ秒を表す整数

1704110400000

使用する場合:

  • JavaScript アプリケーション (Date.now() のデフォルト)
  • 最新の Web API
  • ミリ秒の精度が必要

コード例:

// JavaScript
const timestamp = Date.now();
// 1704110400000

const date = new Date(timestamp);
// 2024-01-01T12:00:00.000Z

# Python
import time
timestamp = int(time.time() * 1000)
# 1704110400000

from datetime import datetime
date = datetime.fromtimestamp(timestamp / 1000)

// Java
long timestamp = System.currentTimeMillis();
// 1704110400000

Date date = new Date(timestamp);
// Mon Jan 01 12:00:00 UTC 2024

// C#
long timestamp = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
// 1704110400000

DateTimeOffset date = DateTimeOffset.FromUnixTimeMilliseconds(timestamp);

マイクロ秒 (16 桁)

形式: Unix エポックからのマイクロ秒を表す整数

1704110400000000

使用する場合:

  • 高精度のロギングとモニタリング
  • パフォーマンスのベンチマーク
  • 科学的応用

コード例:

# Python
import time
timestamp = int(time.time() * 1_000_000)
# 1704110400000000

date = datetime.fromtimestamp(timestamp / 1_000_000)

// Go
timestamp := time.Now().UnixMicro()
// 1704110400000000

date := time.UnixMicro(timestamp)

// Rust
use std::time::{SystemTime, UNIX_EPOCH};

let timestamp = SystemTime::now()
    .duration_since(UNIX_EPOCH)
    .unwrap()
    .as_micros();
// 1704110400000000

ナノ秒 (19 桁)

形式: Unix エポックからのナノ秒を表す整数

1704110400000000000

使用する場合:

  • 超高精度のタイミング要件
  • パフォーマンスプロファイリング
  • 取引システム

コード例:

// Go
timestamp := time.Now().UnixNano()
// 1704110400000000000

date := time.Unix(0, timestamp)

// Rust
let timestamp = SystemTime::now()
    .duration_since(UNIX_EPOCH)
    .unwrap()
    .as_nanos();
// 1704110400000000000

ISO 8601 フォーマット

基本フォーマット (UTC)

形式: `YYYY-MM-DDTHH:MM:SSZ

2024-01-01T12:00:00Z
```
**使用する場合:**
- 国際データ交換
- RESTful API
- JSONデータストレージ

**コード例:**
```javascript
// JavaScript
const isoString = new Date().toISOString();
// 2024-01-01T12:00:00.000Z
```

```python
# Python
from datetime import datetime, timezone
iso_string = datetime.now(timezone.utc).isoformat().replace('+00:00', 'Z')
# 2024-01-01T12:00:00Z
```

```php
// PHP
$iso_string = gmdate('Y-m-d\TH:i:s\Z');
// 2024-01-01T12:00:00Z
```
### 拡張フォーマット (ミリ秒単位)

**形式**: `YYYY-MM-DDTHH:MM:SS.sssZ

2024-01-01T12:00:00.000Z


```javascript
// JavaScript (default)
new Date().toISOString();
// 2024-01-01T12:00:00.000Z

# Python
datetime.now(timezone.utc).isoformat(timespec='milliseconds').replace('+00:00', 'Z')
# 2024-01-01T12:00:00.000Z

タイムゾーンオフセットあり

形式: `YYYY-MM-DDTHH:MM:SS±HH:MM

2024-01-01T12:00:00+00:00
2024-01-01T17:30:00+05:30  # IST
2024-01-01T07:00:00-05:00  # EST
```
**コード例:**
```javascript
// JavaScript
const date = new Date();
const offset = -date.getTimezoneOffset();
const sign = offset >= 0 ? '+' : '-';
const hours = String(Math.floor(Math.abs(offset) / 60)).padStart(2, '0');
const minutes = String(Math.abs(offset) % 60).padStart(2, '0');
const iso = date.toISOString().replace('Z', `${sign}${hours}:${minutes}`);
// 2024-01-01T12:00:00.000+00:00
```

```python
# Python
datetime.now(timezone.utc).isoformat()
# 2024-01-01T12:00:00+00:00

# With specific timezone
from datetime import timezone, timedelta
ist = timezone(timedelta(hours=5, minutes=30))
datetime.now(ist).isoformat()
# 2024-01-01T17:30:00+05:30
```
### 日付のみ

**形式**: `YYYY-MM-DD

2024-01-01


```javascript
// JavaScript
new Date().toISOString().split('T')[0];
// 2024-01-01

# Python
datetime.now().date().isoformat()
# 2024-01-01

時間のみ

形式: HH:MM:SS または `HH:MM:SS.sss

12:00:00
12:00:00.000
```

```javascript
// JavaScript
new Date().toISOString().split('T')[1];
// 12:00:00.000Z
```

```python
# Python
datetime.now().time().isoformat()
# 12:00:00.000000
```
---

## RFC 3339 形式

**形式**: `YYYY-MM-DDTHH:MM:SS.sss±HH:MM` または `...Z

2024-01-01T12:00:00.000Z 2024-01-01T12:00:00.000+00:00

**ISO 8601 との違い:**
- 常にミリ秒を含みます
- 常にタイムゾーンを含めます
- より厳密な仕様

**コード例:**
```javascript
// JavaScript
new Date().toISOString(); // Already RFC 3339 compliant
// 2024-01-01T12:00:00.000Z

# Python
from datetime import datetime, timezone
datetime.now(timezone.utc).isoformat()
# 2024-01-01T12:00:00.000000+00:00

// Go
time.Now().UTC().Format(time.RFC3339Nano)
// 2024-01-01T12:00:00.000000000Z

RFC 2822 形式

形式: `日、DD 月 YYYY HH:MM:SS ±HHMM

Mon, 01 Jan 2024 12:00:00 +0000
Mon, 01 Jan 2024 12:00:00 GMT
```
**使用する場合:**
- 電子メールのヘッダー (日付フィールド)
- HTTPヘッダー
- RSSフィード

**コード例:**
```javascript
// JavaScript
new Date().toUTCString();
// Mon, 01 Jan 2024 12:00:00 GMT
```

```python
# Python
from email.utils import formatdate
formatdate(timeval=None, localtime=False, usegmt=True)
# Mon, 01 Jan 2024 12:00:00 GMT
```

```php
// PHP
date('r');
// Mon, 01 Jan 2024 12:00:00 +0000
```
---

## SQL タイムスタンプ形式

### MySQL/MariaDB 日時

**形式**: `YYYY-MM-DD HH:MM:SS

2024-01-01 12:00:00


```sql
-- MySQL
SELECT NOW();
-- 2024-01-01 12:00:00

SELECT DATE_FORMAT(NOW(), '%Y-%m-%d %H:%i:%s');
-- 2024-01-01 12:00:00

PostgreSQL タイムスタンプ

形式: `YYYY-MM-DD HH:MM:SS.ssssss±TZ

2024-01-01 12:00:00.000000+00
2024-01-01 12:00:00+00
```

```sql
-- PostgreSQL
SELECT NOW();
-- 2024-01-01 12:00:00.000000+00

SELECT CURRENT_TIMESTAMP;
-- 2024-01-01 12:00:00.000000+00
```
### SQLite 日時

**形式**: `YYYY-MM-DD HH:MM:SS` (テキストとして保存)
```
2024-01-01 12:00:00
```

```sql
-- SQLite
SELECT datetime('now');
-- 2024-01-01 12:00:00

SELECT strftime('%Y-%m-%d %H:%M:%S', 'now');
-- 2024-01-01 12:00:00
```
### Microsoft SQL サーバー

**形式**: `YYYY-MM-DD HH:MM:SS.sss

2024-01-01 12:00:00.000


```sql
-- SQL Server
SELECT GETUTCDATE();
-- 2024-01-01 12:00:00.000

SELECT FORMAT(GETUTCDATE(), 'yyyy-MM-dd HH:mm:ss.fff');
-- 2024-01-01 12:00:00.000

言語固有の形式

JavaScript

// Various formats
const date = new Date();

// ISO 8601
date.toISOString();                    // 2024-01-01T12:00:00.000Z

// Locale string
date.toLocaleString();                  // 1/1/2024, 12:00:00 PM

// UTC string
date.toUTCString();                     // Mon, 01 Jan 2024 12:00:00 GMT

// Date only
date.toLocaleDateString();              // 1/1/2024

// Time only
date.toLocaleTimeString();              // 12:00:00 PM

// Custom format
date.toLocaleString('en-US', {
  year: 'numeric',
  month: '2-digit',
  day: '2-digit',
  hour: '2-digit',
  minute: '2-digit',
  second: '2-digit',
  hour12: false
});
// 01/01/2024, 12:00:00

Python strftime コード

from datetime import datetime

dt = datetime(2024, 1, 1, 12, 0, 0)

# Common formats
dt.strftime('%Y-%m-%d')                 # 2024-01-01
dt.strftime('%Y-%m-%d %H:%M:%S')       # 2024-01-01 12:00:00
dt.strftime('%Y-%m-%dT%H:%M:%SZ')      # 2024-01-01T12:00:00Z
dt.strftime('%d/%m/%Y')                 # 01/01/2024
dt.strftime('%m/%d/%Y')                 # 01/01/2024
dt.strftime('%B %d, %Y')                # January 01, 2024
dt.strftime('%A, %B %d, %Y')           # Monday, January 01, 2024
dt.strftime('%I:%M %p')                 # 12:00 PM

PHP date() 形式

<?php
$timestamp = 1704110400;

// Common formats
date('Y-m-d', $timestamp);              // 2024-01-01
date('Y-m-d H:i:s', $timestamp);       // 2024-01-01 12:00:00
date('c', $timestamp);                  // 2024-01-01T12:00:00+00:00 (ISO 8601)
date('r', $timestamp);                  // Mon, 01 Jan 2024 12:00:00 +0000 (RFC 2822)
date('U', $timestamp);                  // 1704110400 (Unix timestamp)
date('d/m/Y', $timestamp);              // 01/01/2024
date('m/d/Y', $timestamp);              // 01/01/2024
date('F j, Y', $timestamp);             // January 1, 2024
date('l, F j, Y', $timestamp);         // Monday, January 1, 2024
date('g:i A', $timestamp);              // 12:00 PM

実行時間の形式

package main

import (
    "time"
)

func main() {
    t := time.Date(2024, 1, 1, 12, 0, 0, 0, time.UTC)

    // Standard formats
    t.Format(time.RFC3339)              // 2024-01-01T12:00:00Z
    t.Format(time.RFC3339Nano)          // 2024-01-01T12:00:00.000000000Z
    t.Format(time.RFC822)               // 01 Jan 24 12:00 UTC
    t.Format(time.RFC1123)              // Mon, 01 Jan 2024 12:00:00 UTC

    // Custom formats (using reference time: Jan 2 15:04:05 2006 MST)
    t.Format("2006-01-02")              // 2024-01-01
    t.Format("2006-01-02 15:04:05")    // 2024-01-01 12:00:00
    t.Format("01/02/2006")              // 01/01/2024
    t.Format("January 2, 2006")         // January 1, 2024
    t.Format("3:04 PM")                 // 12:00 PM
}

Java SimpleDateFormat

import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.TimeZone;

Date date = new Date(1704110400000L);
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'");
sdf.setTimeZone(TimeZone.getTimeZone("UTC"));

// Common patterns
"yyyy-MM-dd"                            // 2024-01-01
"yyyy-MM-dd HH:mm:ss"                  // 2024-01-01 12:00:00
"yyyy-MM-dd'T'HH:mm:ss'Z'"            // 2024-01-01T12:00:00Z
"dd/MM/yyyy"                            // 01/01/2024
"MM/dd/yyyy"                            // 01/01/2024
"MMMM d, yyyy"                          // January 1, 2024
"EEEE, MMMM d, yyyy"                   // Monday, January 1, 2024
"h:mm a"                                // 12:00 PM

フォーマット変換クイックリファレンス

Unix → ISO 8601

// JavaScript
new Date(1704110400000).toISOString();
// 2024-01-01T12:00:00.000Z

# Python
from datetime import datetime, timezone
datetime.fromtimestamp(1704110400, timezone.utc).isoformat()
# 2024-01-01T12:00:00+00:00

ISO 8601 → Unix

// JavaScript
new Date('2024-01-01T12:00:00Z').getTime();
// 1704110400000

# Python
from datetime import datetime
datetime.fromisoformat('2024-01-01T12:00:00+00:00').timestamp()
# 1704110400.0

RFC 2822 → ISO 8601

// JavaScript
new Date('Mon, 01 Jan 2024 12:00:00 GMT').toISOString();
// 2024-01-01T12:00:00.000Z

# Python
from email.utils import parsedate_to_datetime
parsedate_to_datetime('Mon, 01 Jan 2024 12:00:00 GMT').isoformat()
# 2024-01-01T12:00:00+00:00

ベストプラクティス

ストレージに関する推奨事項

  1. データベース: タイムゾーンをサポートするネイティブ TIMESTAMP タイプを使用する
  2. API: 移植性を高めるため、タイムゾーンを含む ISO 8601 を使用します。
  3. 内部処理: 計算には Unix ミリ秒を使用します
  4. ログ: ミリ秒とタイムゾーンで ISO 8601 を使用します。

タイムゾーンの処理

  • 常にタイムゾーンを含める - 曖昧なタイムスタンプを避ける
  • UTC で保存 - 表示の場合のみ現地時間に変換します
  • UTC には Z を使用 - +00:00 より明確
  • タイムゾーン オフセットを検証します - -12:00 ～ +14:00 の範囲内であることを確認します

精密な選択

精度使用例例
秒ユーザー イベント、スケジュール設定1704110400
ミリ秒Web アプリ、一般的なログ1704110400000
マイクロ秒パフォーマンス監視1704110400000000
ナノ秒高頻度取引1704110400000000000

よくある落とし穴

❌ 避けてください:

  • タイムゾーン情報を含まないタイムスタンプの保存
  • 保存には現地時間を使用します (常に UTC を使用します)。
  • 異なる精度レベルの混合
  • タイムゾーンオフセットのハードコーディング
  • 32ビット整数の使用（2038年問題）

✅ 実行してください:

  • タイムゾーン指定子 (Z または ±HH:MM) を常に含めます。
  • UTC で保存し、表示のみを目的として現地時間に変換します
  • システム全体で一貫した精度を使用します
  • タイムゾーン対応の日時オブジェクトを使用する
  • Unix タイムスタンプには 64 ビット整数を使用します

関連ツール

関連ガイド