ForHosting KIT · 開発者向けツール

JavaScriptタイムスタンプをISO 8601に変換

JavaScriptタイムスタンプを、現在時刻、ブラウザーのロケール、サーバー時計に依存しない正確なISO 8601日時へ変換します。Unixエポックからのミリ秒を整数で入力すると、3桁のミリ秒と末尾のZを含むUTC日時が返ります。計算は決定的で、同じ数値からは常に同じ文字列が得られます。1970年より前の負の値とJavaScriptの時刻値の全範囲にも対応するため、ログ調査、移行、再現可能なテストに適しています。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

秒ではなくミリ秒を入力してください

JavaScriptのタイムスタンプは通常、1970-01-01T00:00:00.000Zからのミリ秒を数えますが、多くのUnixツールやAPIは秒を数えます。この1,000倍の違いが、予想外の変換結果を招く最も一般的な原因です。JavaScriptが返した数値を、引用符、区切り、単位、計算式を付けずにそのまま入力してください。3桁の小数秒を持つISO文字列は整数ミリ秒を正確に表すため、この変換では整数だけを受け付けます。小数、有限でない値、数値を表す文字列は、丸めたり推測したりせず拒否されます。この厳密な検証により、不正な入力からもっともらしい誤日時が作られることを防げます。入力元が秒単位の場合は、対応範囲内に収まることを確認してから1,000倍してください。timestamp_msフィールドには受理した数値が再掲され、元データと整形結果の対応を明確に保てます。

決定的なUTC結果をご確認ください

結果はUTCのISO 8601日時です。末尾のZはUTCからのオフセットがゼロであることを示し、リクエストした方のローカルタイムゾーンを意味しません。そのため、時、分、秒、ミリ秒は地域、夏時間、実行環境の設定が変わっても一定です。計算では時計を参照せず、JavaScriptのDateオブジェクトも使用しません。タイムスタンプをUTCの通日とその日の非負の時刻に分け、範囲が定まったグレゴリオ暦の整数演算で日付へ変換します。同じ入力がロケールや実行日時によって変化しないため、テストデータ作成や障害調査にも安心して使えます。負の値には床関数による除算を使うので、Unixエポック直前の1ミリ秒は正しく1969-12-31に属します。0000～9999年の外側は符号付き拡張年形式で表します。

出力を安全に活用してください

エポック数値より標準UTC表記が読みやすい場面でisoフィールドをご利用ください。構造化ログ、デバッグコンソール、監査出力、JSONフィクスチャ、移行報告、APIレスポンスなどに適しています。元の数値と文字列を一緒に保存すると、秒とミリ秒の取り違えを見つけやすくなります。この処理は書式変換であり、タイムゾーンの現地化、イベント発生地の推定、地域向け表示は行いません。それらは別工程で行い、転送と比較にはUTC値を保持してください。対応範囲はJavaScriptの一般的な上限であるプラスマイナス8,640,000,000,000,000ミリ秒です。範囲外、NaN、Infinity、未指定、文字列、小数は拒否されます。ネットワーク、乱数、ロケール、現在時刻は結果に影響しません。APIは$0.002で呼び出せ、ブラウザー版でも常に再現可能な結果が得られます。

活用例

アプリケーションログの確認

不透明なミリ秒フィールドを、サービスや地域を越えて比較できるUTC時刻に変換します。

安定したテストデータの作成

時計やタイムゾーンに左右されず、固定タイムスタンプから標準ISO値を生成します。

時刻移行の監査

データベースやAPIの変換を確認するとき、元の数値とISO表記を並べて保持します。

よくある質問

入力単位は秒ですか、ミリ秒ですか？

ミリ秒です。JavaScriptはUnixエポックからのミリ秒を数えるため、秒単位の値は先に1,000倍してください。

ローカルタイムゾーンは使われますか？

いいえ。末尾のZが示すとおり常にUTCであり、ブラウザーやサーバーの設定には依存しません。

1970年より前の日付も変換できますか？

はい。負のタイムスタンプを入力すると、対応するグレゴリオ暦のUTC日時が返ります。

小数が拒否されるのはなぜですか？

正確な整数ミリ秒を3桁で表す仕様のため、暗黙の丸めを避ける目的で拒否します。

料金はいくらですか？

API変換1回の料金は$0.002です。ブラウザーでも決定的な対話変換をご利用いただけます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/date/js-timestamp-to-iso

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/date/js-timestamp-to-iso \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timestamp":1717245296789}'

const res = await fetch("https://api.kit.forhosting.com/date/js-timestamp-to-iso", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "timestamp": 1717245296789
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/js-timestamp-to-iso",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "timestamp": 1717245296789
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/js-timestamp-to-iso", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"timestamp":1717245296789}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"timestamp":1717245296789}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/js-timestamp-to-iso", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "timestamp": 1717245296789
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.js_timestamp_to_iso",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →