メイン コンテンツをスキップする 補完的コンテンツへスキップ

localtime - スクリプトおよびチャート関数

この関数は、指定されたタイム ゾーンの現在の時刻のタイムスタンプを返します。

構文:  

LocalTime([timezone [, ignoreDST ]])

戻り値データ型: dual

引数
引数 説明
timezone

timezoneは、Windows Control PanelDate and TimeTime Zone にリストされているいずれかの場所を含む文字列、あるいは 'GMT+hh:mm' 形式の文字列として指定されます。受け入れ可能な場所とタイムゾーンのリストについても下の表に示されています。

タイムゾーンが指定されていない場合は、現地時間が返されます。

情報メモDST オフセットを使用する場合 (つまり、False を評価する ignoreDST 引数値を指定する場合)、place 引数に GMT オフセットではなく場所を指定する必要があります。これは、夏時間に合わせて調整するには、GMT オフセットによって提供される経度情報に加えて、緯度情報も必要となるためです。詳細については、「GMT オフセットを DST と組み合わせて使用する」を参照してください。
ignoreDST

この引数が True と評価される場合、DST (夏時間) は無視されます。True と評価される有効な引数値には、-1True() などがあります。

この引数が False と評価された場合、タイムスタンプは夏時間に合わせて調整されます。False と評価される有効な引数値には、0False() などがあります。

ignoreDST 引数値が無効な場合、関数は ignore_dst 値が True と評価されるかのように数式を評価します。ignoreDST 引数値が指定されていない場合、関数は ignore_dst 値が False と評価されるかのように数式を評価します。

有効な場所とタイム ゾーン
A-C D-K L-R S-Z
Abu Dhabi Darwin La Paz Samoa
AdelaideDhakaLimaSantiago
AlaskaEastern Time (US & Canada)LisbonSapporo
AmsterdamEdinburghLjubljanaSarajevo
ArizonaEkaterinburgLondonSaskatchewan
AstanaFijiMadridSeoul
AthensGeorgetownMagadanSingapore
Atlantic Time (Canada)GreenlandMazatlanSkopje
AucklandGreenwich Mean Time : DublinMelbourneSofia
AzoresGuadalajara Mexico CitySolomon Is.
BaghdadGuamMid-AtlanticSri Jayawardenepura
BakuHanoiMinskSt. Petersburg
BangkokHarareMonroviaStockholm
BeijingHawaiiMonterreySydney
BelgradeHelsinkiMoscowTaipei
BerlinHobartMountain Time (US & Canada)Tallinn
BernHong KongMumbaiTashkent
BogotaIndiana (East)MuscatTbilisi
BrasiliaInternational Date Line WestNairobiTehran
BratislavaIrkutskNew CaledoniaTokyo
BrisbaneIslamabadNew DelhiUrumqi
BrusselsIstanbulNewfoundlandWarsaw
BucharestJakartaNovosibirskWellington
BudapestJerusalemNuku'alofaWest Central Africa
Buenos AiresKabulOsakaVienna
CairoKamchatkaPacific Time (US & Canada)Vilnius
CanberraKarachiParisVladivostok
Cape Verde Is.KathmanduPerthVolgograd
CaracasKolkataPort MoresbyYakutsk
CasablancaKrasnoyarskPragueYerevan
Central AmericaKuala LumpurPretoriaZagreb
Central Time (US & Canada)KuwaitQuito-
ChennaiKyivRiga-
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 と組み合わせて使用する

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

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

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。