# converttolocaltime スクリプトおよびチャート関数

UTC または GMT のタイムスタンプをデュアル値として現地時間に変換します。世界中の任意の都市、場所、タイム ゾーンを指定できます。

構文:

ConvertToLocalTime(timestamp [, place [, ignore\_dst=false]])

戻り値データ型： デュアル

引数

| 引数 | 説明 |
| --- | --- |
| timestamp | 変換するタイムスタンプまたは計算結果がタイムスタンプになる数式。 |
| place | 下記の有効な場所とタイム ゾーンの表に示された場所またはタイム ゾーン。あるいは、GMT または UTC を使用して現地時間を定義できます。次の値とタイム オフセットの範囲が有効です。<br><br><ul> <li> <span>GMT</span> </li> <li> <span>GMT-12:00 - GMT-01:00</span> </li> <li> <span>GMT+01:00 - GMT+14:00</span> </li> <li> <span>UTC</span> </li> <li> <span>UTC-12:00 - UTC-01:00</span> </li> <li> <span>UTC+01:00 - UTC+14:00</span> </li> </ul><br><br>情報メモDST オフセットを使用する場合 (つまり、False を評価する ignore\_dst 引数値を指定する場合)、place 引数に GMT オフセットではなく場所を指定する必要があります。これは、夏時間に合わせて調整するには、GMT オフセットによって提供される経度情報に加えて、緯度情報も必要となるためです。詳細については、「[GMT オフセットを DST と組み合わせて使用する](https://help.qlik.com/ja-JP/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/converttolocaltime.htm#Using)」を参照してください。<br><br>情報メモ標準タイム オフセットのみ使用できます。GMT-04:27 など、任意のタイム オフセットを使用することはできません。 |
| ignore\_dst | この引数が True と評価される場合、DST (夏時間) は無視されます。True と評価される有効な引数値には、`-1` や `True()` などがあります。<br><br>この引数が False と評価された場合、タイムスタンプは夏時間に合わせて調整されます。False と評価される有効な引数値には、`0` や `False()` などがあります。<br><br>ignore\_dst 引数値が無効な場合、関数は ignore\_dst 値が True と評価されるかのように数式を評価します。ignore\_dst 引数値が指定されていない場合、関数は ignore\_dst 値が False と評価されるかのように数式を評価します。 |

有効な場所とタイム ゾーン

| A-C | D-K | L-R | S-Z |
| --- | --- | --- | --- |
| Abu Dhabi | Darwin | La Paz | Samoa |
| Adelaide | Dhaka | Lima | Santiago |
| Alaska | Eastern Time (US & Canada) | Lisbon | Sapporo |
| Amsterdam | Edinburgh | Ljubljana | Sarajevo |
| Arizona | Ekaterinburg | London | Saskatchewan |
| Astana | Fiji | Madrid | Seoul |
| Athens | Georgetown | Magadan | Singapore |
| Atlantic Time (Canada) | Greenland | Mazatlan | Skopje |
| Auckland | Greenwich Mean Time : Dublin | Melbourne | Sofia |
| Azores | Guadalajara | Mexico City | Solomon Is. |
| Baghdad | Guam | Mid-Atlantic | Sri Jayawardenepura |
| Baku | Hanoi | Minsk | St. Petersburg |
| Bangkok | Harare | Monrovia | Stockholm |
| Beijing | Hawaii | Monterrey | Sydney |
| Belgrade | Helsinki | Moscow | Taipei |
| Berlin | Hobart | Mountain Time (US & Canada) | Tallinn |
| Bern | Hong Kong | Mumbai | Tashkent |
| Bogota | Indiana (East) | Muscat | Tbilisi |
| Brasilia | International Date Line West | Nairobi | Tehran |
| Bratislava | Irkutsk | New Caledonia | Tokyo |
| Brisbane | Islamabad | New Delhi | Urumqi |
| Brussels | Istanbul | Newfoundland | Warsaw |
| Bucharest | Jakarta | Novosibirsk | Wellington |
| Budapest | Jerusalem | Nuku'alofa | West Central Africa |
| Buenos Aires | Kabul | Osaka | Vienna |
| Cairo | Kamchatka | Pacific Time (US & Canada) | Vilnius |
| Canberra | Karachi | Paris | Vladivostok |
| Cape Verde Is. | Kathmandu | Perth | Volgograd |
| Caracas | Kolkata | Port Moresby | Yakutsk |
| Casablanca | Krasnoyarsk | Prague | Yerevan |
| Central America | Kuala Lumpur | Pretoria | Zagreb |
| Central Time (US & Canada) | Kuwait | Quito | - |
| Chennai | Kyiv | Riga | - |
| Chihuahua | - | Riyadh | - |
| Chongqing | - | Rome | - |
| Copenhagen | - | - | - |

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/converttolocaltime.htm)

#### 例と結果:

スクリプトの例

| 例 | 結果 |
| --- | --- |
| `ConvertToLocalTime('2023-08-14 08:39:47','Paris')` | 「2023-08-14 10:39:47」と、対応するタイムスタンプの内部表現を返します。 |
| `ConvertToLocalTime(UTC(), 'Stockholm')` | 夏時間の調整をして、ストックホルムの時間を返します。 |
| `ConvertToLocalTime(UTC(), 'Stockholm', -1)` | 夏時間の調整なしで、ストックホルムの時間を返します。 |
| `ConvertToLocalTime(UTC(), 'GMT-05:00')` | 北米東海岸 (ニューヨークなど) の時刻を返します。場所ではなく GMT オフセットが指定されているため、夏時間の調整は行われません。 |
| `ConvertToLocalTime(UTC(), 'New York', -1)` | 夏時間の調整なしで、北米東海岸 (ニューヨーク) の時刻を返します。 |
| `ConvertToLocalTime(UTC(), 'New York', True())` | 夏時間の調整なしで、北米東海岸 (ニューヨーク) の時刻を返します。 |
| `ConvertToLocalTime(UTC(), 'New York', 0)` | 夏時間の調整をして、北米東海岸 (ニューヨーク) の時刻を返します。 |
| `ConvertToLocalTime(UTC(), 'New York', False())` | 夏時間の調整をして、北米東海岸 (ニューヨーク) の時刻を返します。 |

## GMT オフセットを DST と組み合わせて使用する

Qlik Sense で International Components for Unicode (ICU) ライブラリを実装した後、GMT (グリニッジ標準時) オフセットを DST (夏時間) と組み合わせて使用するには、追加の緯度情報が必要になります。

GMT は経度 (東西) オフセットであるのに対し、DST は緯度 (南北) オフセットです。例えば、ヘルシンキ (フィンランド) とヨハネスブルグ (南アフリカ) は同じ GMT+02:00 オフセットを共有しますが、同じ DST オフセットは共有しません。つまり、現地の DST 条件に関する完全な情報を得るために、GMT オフセットに加えて、DST オフセットでも現地のタイム ゾーンの緯度位置に関する情報 (地理的タイム ゾーン入力) が必要となります。