_get_tzname
タイム ゾーンの名前または daylight 標準時のタイム ゾーンの名前 (DST) の文字列表現を取得します。
errno_t _get_tzname(
size_t* pReturnValue,
char* timeZoneName,
size_t sizeInBytes,
int index
);
パラメーター
[出力] pReturnValue
Null 終端文字など timeZoneName に文字列長を返します。[出力] timeZoneName
indexしてタイム ゾーンの名前または daylight 標準時のタイム ゾーンの名前 (DST) 表現には文字列のアドレス。[入力] sizeInBytes
バイトの timeZoneName の文字列のサイズ。[入力] index
取得するする 2 種類のタイム ゾーンの名前の 1 種類のインデックス。
戻り値
それ以外の場合は、errno 型の値が成功した場合はゼロ。
timeZoneName が NULLであるか、または sizeInBytes がゼロまたは未満ゼロ (ただし、両方) の場合、無効なパラメーター ハンドラーが パラメーターの検証"に説明されているように、呼び出されます。 実行の継続が許可された場合、この関数は errno を EINVAL に設定し、EINVAL を返します。
エラー条件
pReturnValue |
timeZoneName |
sizeInBytes |
index |
戻り値 |
timeZoneName の内容 |
|---|---|---|---|---|---|
TZ の名前のサイズ |
NULL |
0 |
0 または 1 |
0 |
変更されない |
TZ の名前のサイズ |
任意 |
> 0 |
0 または 1 |
0 |
TZ は名前を付けます。 |
変更されない |
NULL |
> 0 |
任意 |
EINVAL |
変更されない |
変更されない |
任意 |
0 |
任意 |
EINVAL |
変更されない |
変更されない |
任意 |
> 0 |
> 1 |
EINVAL |
変更されない |
解説
_get_tzname 関数は pReturnValueの文字列のサイズとともにインデックス値を使用して timeZoneName のアドレスにタイム ゾーンの名前または daylight 標準時のタイム ゾーンの名前 (DST) の文字列形式を、取得します。 timeZoneName が NULL であり、sizeInBytes がゼロの場合、バイトのタイム ゾーンの一連のサイズは、pReturnValueで返されます。 インデックス値は標準時タイム ゾーンの 0 または daylight 標準時のタイム ゾーンの必ず 1; インデックスのそのほかの値には不定の結果になります。
インデックス値
index |
timeZoneName の内容 |
timeZoneName の 既定値 |
|---|---|---|
0 |
タイム ゾーンの名前 |
「PST」 |
1 |
Daylight 標準時のタイム ゾーンの名前 |
「PDT」 |
> 1 または < 0 |
errno は EINVALに設定します。 |
変更されない |
値が実行時中に明示的に変更するには、既定値「PST」、および「PDT」です。これらの文字配列のサイズは TZNAME_MAX 値によって決まります。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_get_tzname |
<time.h> |
詳細については、「互換性」を参照してください。
同等の .NET Framework 関数
使用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。