ForHosting KIT · 開発者向けツール

分をUTCオフセットへ変換

分からUTCオフセットへのフォーマッターは、符号付き整数をUTC+05:30やUTC-04:00のような安定した数値文字列へ変換します。使用するのはお客様が送信した値だけです。そのため、結果は現在の日付、端末の時計、ブラウザーのロケール、地理的位置、夏時間の規則、タイムゾーンデータベースのいずれにも左右されません。出力には必ずUTCという接頭辞、明示的な符号、2桁の時、コロン、2桁の分が含まれます。設定画面、正規化済みレコード、テスト、ログ、データ交換に安心してご利用いただけます。

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

無料で実行 API仕様を見る

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

符号付きの整数分をご入力ください

minutesという項目に整数を1つご指定ください。正の値はUTCより進んだオフセット、負の値はUTCより遅れたオフセット、ゼロはUTCとの差がないことを表します。たとえば330は5時間30分進んだ値、-240は4時間遅れた値です。入力を分で表すことで、小数時間の曖昧さを避けられます。5.5時間は人には分かりやすくても、330分なら正確であり、浮動小数点として解釈する必要がありません。受け付ける範囲は-840から840までで、UTC-14:00からUTC+14:00に相当し、実際に用いられる民間時のUTCオフセット範囲を網羅します。小数、数字の文字列、未指定の値、有限でない数、範囲外の値は、丸めたり暗黙に変換したりせず拒否します。この厳密な検証により、お客様が意図したオフセットが設定やスケジュール処理でわずかに変わる事故を防げます。正しい値は呼び出し前に計算または取得してください。都市、国、略称、名前付きタイムゾーン、タイムスタンプ、端末設定から値を推測する機能ではありません。同じ整数には常に同じ処理を適用します。

標準形UTC±HH:MMの結果をご確認ください

アルゴリズムは入力から符号を直接決め、絶対値を整数時間と残りの分に分け、それぞれを2桁になるようゼロで補います。330はUTC+05:30、-75はUTC-01:15、60はUTC+01:00になります。ゼロはUTC+00:00として表し、ほかの結果と同じ固定構造を保ちます。特別な略記Zや短縮したUTC表記には置き換えません。コロンは必ず入り、値がゼロでも時や分を省略しません。この安定した形式は、画面表示、スナップショットテスト、設定の書き出し、自動生成文書、正規化文字列を比較するシステムに適しています。応答にはoffset_minutesも含まれ、整形済みオフセットと並んで検証済みの数値入力が保持されます。文字列を表示しつつ、並べ替え、計算、保存には整数を利用できるため、表示文字列を再解析する必要がありません。ここで標準形とは、この機能が定める大文字のUTC、明示的な正負記号、ゼロ埋めしたHH:MMという出力形式を指します。地理的なタイムゾーンを特定するものではありません。

固定オフセットと名前付きタイムゾーンを区別してください

数値のUTCオフセットは、Europe/LondonやAmerica/New_Yorkのような名前付きタイムゾーンと同じものではありません。名前付きゾーンには過去と将来の規則が含まれ、夏時間の切り替えや法改正によって有効なオフセットが変わる場合があります。このフォーマッターはそのような検索を行わず、お客様が指定した正確な数値だけを表現します。固定オフセット自体が正しいデータである場合、別の場所で計算した値を正規化する場合、タイムゾーンデータベースの更新で変化してはならない決定的なテストデータを作る場合にご利用ください。人の現地時刻を調べる、特定日の都市に適用されるオフセットを判断する、名前付きゾーンを季節ごとの値へ変換するといった用途には適していません。ネットワーク通信、乱数、時計の参照、ロケール依存、実行環境の調査、非公開の既定値は一切ありません。そのため、APIとブラウザーのどちらでも再現可能です。APIリクエストは1回$0.002です。不正な入力には型付きエラーと簡潔な説明を返しますので、推測値を採用せず項目を修正していただけます。offset_minutesを数値の原本、offsetを正規化済み表示としてお使いください。

活用例

設定値を正規化する

保存された分単位のオフセットを、設定、API、エクスポート向けの統一されたUTC±HH:MM形式へ変換します。

オフセット選択肢を作る

対応表を手作業で管理せず、画面に表示する一貫した数値ラベルを生成します。

再現可能なテストデータを作る

時計、ロケール、タイムゾーンデータベースの版に依存せず、整数から期待する文字列を生成します。

よくある質問

0分を入力すると何が返りますか？

UTC+00:00を返し、ほかの結果と同じ明示的な符号と固定幅を維持します。

小数の分は丸められますか？

いいえ。分は整数である必要があり、小数を指定すると入力不正エラーになります。

都市の現在のオフセットを調べられますか？

いいえ。指定された符号付き数値だけを整形し、地理情報や夏時間規則は参照しません。

時と分を常に2桁で表示するのはなぜですか？

ゼロ埋めにより、画面、レコード、テストで予測可能なUTC±HH:MM表現を提供するためです。

APIリクエストの料金はいくらですか？

APIリクエストは1回$0.002です。同じ決定的な処理をブラウザーでも実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/minutes-to-offset

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

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

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

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

import os, requests

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

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

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

リクエスト例

{
  "minutes": 330
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.minutes_to_offset",
  "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の完全なドキュメントを見る →