localtime - スクリプトおよびチャート関数
この関数は、指定されたタイム ゾーンのシステム クロックから取得した現在の時刻のタイムスタンプを返します。
構文:
LocalTime([timezone [, ignoreDST ]])
戻り値データ型: デュアル
| 引数 | 説明 |
|---|---|
| timezone |
timezone は、[Windows コントロール パネル] の [日付と時間] で [タイム ゾーン設定] にリストされているいずれかの場所を含む文字列、あるいは 'GMT+hh:mm' 形式の文字列として指定されます。使用できる場所とタイムゾーンの一覧は、以下の表の通りです。 タイムゾーンが指定されていない場合は、現地時間が返されます。 情報メモDST オフセットを使用する場合 ( False を評価する ignoreDST 引数値を指定する)、place 引数では GMT オフセットではなく場所を指定する必要があります。これは、夏時間の調整には、GMT オフセットが提供する経度情報に加えて、緯度情報が必要なためです。詳細については、「GMT オフセットを DST と組み合わせて使用する」を参照してください。
|
| ignoreDST |
この引数が True を評価する場合、DST (夏時間) は無視されます。有効な引数値には、-1 と True() が含まれます。 この引数が False を評価する場合、日付と時刻は夏時間に調整されます。有効な引数値には、0 と False() が含まれます。 ignoreDST 引数値が無効な場合、関数は ignoreDST 値を True と評価して数式を評価します (夏時間は無視される)。ignoreDST 引数値が指定されない場合、関数は ignoreDST 値を 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 | - | - | - |
例と結果:
以下の例は、現地時間 2023-08-14 08:39:47 にこの関数が呼び出され、サーバーまたはデスクトップ環境の現地タイムゾーンが GMT-05:00 で、この日付時点で夏時間が導入されている地域であるという条件に基づいています。
| 例 | 結果 |
|---|---|
|
localtime () |
現地時刻 2023-08-14 08:39:47 を返します。 |
|
localtime ('London') |
ロンドンの現地時刻 2023-08-14 13:39:47 を返します。 |
|
localtime ('GMT+02:00') |
GMT+02:00 のタイムゾーンの現地時間 2023-08-14 14:39:47 を返します。場所ではなく GMT オフセットが指定されているため、夏時間調整は実行されていません。 |
|
localtime ('Paris',-1) |
夏時間を無視したパリの現地時間 2023-08-14 13:39:47 を返します。 |
|
localtime ('Paris',True()) |
夏時間を無視したパリの現地時間 2023-08-14 13:39:47 を返します。 |
|
localtime ('Paris',0) |
夏時間を考慮したパリの現地時間 2023-08-14 14:39:47 を返します。 |
|
localtime ('Paris',False()) |
夏時間を考慮したパリの現地時間 2023-08-14 14:39:47 を返します。 |
GMT オフセットを DST と組み合わせて使用する
QlikView 2018 年 11 月の International Components for Unicode (ICU) ライブラリの実装後、GMT (グリニッジ標準時) オフセットを DST (夏時間) と組み合わせて使用する場合、緯度情報を追加する必要があります。
GMT は経度 (東西) オフセットで、DST は緯度 (南北) オフセットです。例えば、ヘルシンキ (フィンランド) とヨハネスブルグ (南アフリカ) noは同じ GMT+02:00 オフセットを共有していますが、同じ夏時間オフセットは共有していません。つまり、GMT オフセットに加え、DST オフセットでは、現地の DST 条件に関する詳細な情報を取得するために現地のタイムゾーンの緯度位置に関する情報 (地理的タイムゾーン入力) gaを必要とする。