ascftime(3C)

名前 | 形式 | 機能説明 | 戻り値 | 使用例 | 属性 | 関連項目 | 注意事項

名前

strftime, cftime, ascftime– 日付と時刻を文字列に変換

形式

#include <time.h>

size_t strftime(char *restrict s, size_t maxsize, const char *restrict format, const struct tm *restrict timeptr);
int cftime(char *s, char *format, const time_t *clock);
int ascftime(char *s, const char *format, const struct tm *timeptr);

機能説明

strftime()、ascftime()、cftime() 関数は、format がポイントする文字列の制御に従って、バイトを s がポイントする配列に格納します。format 文字列は、0 個以上の変換仕様と通常文字からなります。変換仕様は、パーセント記号 (%) の後に、変換の内容を表す 1 つ以上の文字を伴います。終了 NULL バイトを含む通常文字すべては、そのまま s が示す配列に複写されます。コピーが、オーバーラップするオブジェクト間で行われた場合には、動作は定義されません。strftime() の場合は、maxsize を超えないバイト数の文字だけが配列に格納されます。

format が (char *)0 であれば、そのロケールのデフォルト形式が使用されます。strftime() の場合は、デフォルト形式は %c と同じになります。また、cftime() や ascftime() の場合は、デフォルト形式は %C と同じになります。cftime() も ascftime() も、まず環境変数の値 CFTIME を利用しようとしますが、これが未定義または空であれば、デフォルト形式を使用します。

各変換仕様は、以下の一覧に示したように、適切な文字に置き換えられます。適切な文字は、プログラムのロケールの LC_TIME カテゴリと、strftime() と ascftime() の timeptr がポイントする構造体に入っている値、cftime() の clock で表されている時間で決まります。

%%

% と同じ

%a

省略形式の曜日名 (ロケール固有)

%A

完全形式の曜日名 (ロケール固有)

%b

省略形式の月名 (ロケール固有)

%B

完全形式の月名 (ロケール固有)

デフォルト

%c

日時の表現 (ロケール固有)

%a %b %d %H:%M:%S %Y

これは、Solaris 2.4 より以前に最初にサポートされた標準準拠と同様に、デフォルトの表現です。 standards(5) を参照してください。

標準準拠

%c

日時の表現 (ロケール固有)

%a %b %e %H:%M:%S %Y

これは、Solaris 2.4 で最初にサポートされて以来、Solaris 10 にいたるまでの標準準拠の表現です。

デフォルト

%C

date(1) が出力する形式の日時の表現

これは、Solaris 2.4 より以前に最初にサポートされた標準準拠と同様に、デフォルトの表現です。

標準準拠

%C

世紀を 01 から 99 までの数値で表現 (年を 100 で割って整数に切り捨て)

これは、Solaris 2.4 で最初にサポートされて以来、Solaris 10 にいたるまでの標準準拠の表現です。

%d

日 (01 から 31)。

%D

%m/%d/%y 形式で表した日付

%e

日 (1 から 31)。1 桁の場合は前に空白文字が付加される

%F

%Y-%m-%d (ISO 8601:2000 標準の日付形式) と同じ

%g

週をベースにした西暦年の下 2 桁 (00 から 99)

%G

週をベースにした西暦年の完全表示 (0000 から 9999)

%h

省略形式の月名 (ロケール固有)

%H

24 時間表示で表した時 (00 から 23)。

%I

12 時間表示で表した時 (01 から 12)。

%j

年の通算日 (001 から 366)。

%k

24 時間表示で表した時 (0 から 23)。1 桁の場合は前に空白文字が付加される

%l

12 時間表示で表した時 (1 から 12)。1 桁の場合は前に空白文字が付加される

%m

月 (01 から 12)。

%M

分 (00 から 59)。

%n

復帰改行を挿入

%p

午前または午後を表す値 (ロケール固有)

%r

%p を伴った、12 時間表示形式で表した時刻

%R

%H:%M 形式で表した時刻

%S

秒 (00 から 60)。値の範囲が (00 から 59) ではなく、(00 から 60) であるのは、うるう秒に対処するため

%t

タブを挿入

%T

%H:%M:%S 形式で表した時刻

%u

曜日を表す番号 (1 から 7)。月曜日が 1 (「注意事項」を参照)

%U

その年の何週目かを表す数値 (00 から 53)。第 1 週はその年の最初の日曜日から始まるとする

%V

ISO 8601 で何週目かを表す数値 (01 から 53)。ISO 8601 の週をベースとするシステムでは、週は月曜日から始まり、1 月 4 日およびその年の最初の木曜日の両方を含む週が第 1 週となる。その年の最初の月曜日が 1 月 1 日、2 日、3 日、または 4 日の場合には、その週は前年の最終週の一部になる (「注意事項」を参照)

%w

曜日を表す番号 (0 から 6)。日曜日が 0

%W

その年の何週目かを表す数値 (00 から 53)。第 1 週はその年の最初の月曜日から始まるとする

%x

ロケール固有の適切な日付の表現

%X

ロケール固有の適切な時刻の表現

%y

西暦年の下 2 桁 (00 から 99)

%Y

西暦年の完全表示 (たとえば 1993)

%z

ISO 8601:2000 標準形式 (+hhmm または -hhmm) の UTC からのオフセットに置き換わります。タイムゾーンがわからない場合には、文字列には置き換えられません。たとえば、"-0430" は、UTC から 4 時間 30 分おくれ (グリニッジから西に離れていること) を意味します。tm_isdst が 0 の場合には、標準時間のオフセットが使用されます。tm_isdst が正の値の場合には、夏時間のオフセットが使用されます。tm_isdst が負の値の場合には、文字列は返されません。

%Z

タイムゾーン名または省略形 (タイムゾーンがない場合には文字なし)

上記の変換仕様または後述する変更指定のどれにも 該当しない指定を記述すると、変換結果は未定義で 0 が返されます。

%U と %W (このほか、後述の %OU と %OW) とでは、何曜日を週の第 1 日目とするかが異なっています。たとえば、1 月の第 1 週目 (週番号 1) は、%U では日曜日から、%W では月曜日から始まります。また、週番号 0 には、%U では 1 月の第 1 日曜日より前の日が、%W では 1 月の第 1 月曜日より前の日が含まれています。

変換仕様の変更

上記の変換仕様に、変更を表す文字 E または O を付加することができます。このようにすると、代替形式または代替指定で値を得ることが可能です。希望した代替形式または代替指定が 現ロケール中に存在していなければ、変更を示す文字を指定しなかった場合の形式で値が得られます。

%Ec

適切な日付および時刻の代替形式 (ロケール固有)

%EC

代替表示形式として指定されている年号 (ロケール固有)

%Eg

代替表示形式として指定されている年号 (%EC) に対応した週をベースとした年 (ロケール固有)

%EG

完全形式の週をベースとした代替年表示

%Ex

日付の代替表示形式 (ロケール固有)

%EX

時刻の代替表示形式 (ロケール固有)

%Ey

代替表示形式として指定されている年号 (%EC) に対応した年 (ロケール固有)

%EY

完全形式の代替年表示

%Od

日をロケール固有の代替数値記号で表す

%Oe

%Od と同じ

%Og

ロケール固有の週をベースとした代替表示の年 (%C に対応) の値を、ロケール固有の代替数値記号で表す

%OH

24 時間表示での時をロケール固有の代替数値記号で表す

%OI

12 時間表示での時をロケール固有の代替数値記号で表す

%Om

月をロケール固有の代替数値記号で表す

%OM

分をロケール固有の代替数値記号で表す

%OS

秒をロケール固有の代替数値記号で表す

%Ou

週日を示す値をロケール固有の代替数値記号にある数字で表す

%OU

その年の何週目かをロケール固有の代替数値記号で表す。週は日曜日から始まるとする

%Ow

曜日を示す値をロケール固有の代替数値記号で表す。日曜日を 0 とする

%OW

その年の何週目かをロケール固有の代替数値記号で表す。週は月曜日から始まるとする

%Oy

ロケール固有の代替表示の年 (%C に対応) の値を、ロケール固有の代替数値記号で表す

出力言語の選択

デフォルトでは、strftime()、cftime()、ascftime() は米国英語で表示されます。setlocale() で LC_TIME カテゴリのロケールを設定すると、strftime()、cftime()、ascftime() の実行結果を特定の言語で出力できるようになります。

時間帯

tzset(3C) を呼び出した場合と同じタイムゾーン情報を使用します。

戻り値

strftime()、cftime()、ascftime() 関数は、s が示す配列に書き出した文字数を返します。これには終了 NULL 文字は含まれません。生成された文字の合計数 (終了 NULL 文字を含む) が maxsize を超えていると、strftime() は、0 を返し、配列の内容は未確定になります。

使用例

---

例 1 strftime() 関数の例




ここでは、POSIX ロケールの strftime() の使用例を示します。tmptr が指す構造体に 1986 年 8 月 28 日木曜日 12 時 44 分 36 秒 に対応する値が入っている場合、文字列 str の内容がどうなるかを示します。

strftime (str, strsize, "%A %b %d %j", tmptr)

これにより、str の内容は "Thursday Aug 28 240" になります。

---

属性

以下の属性については、attributes(5) を参照してください。

属性タイプ	属性値
MT レベル	MT-Safe
CSI	対応済み
インタフェースの安定性	strftime() が標準

関連項目

date(1), ctime(3C), mktime(3C), setlocale(3C), strptime(3C), tzset(3C), TIMEZONE(4), zoneinfo(4), attributes(5), environ(5), standards(5)

注意事項

Solaris 7 では、%V の変換仕様が変わりました。この変更は、現時点で公表されている ISO C9x 標準の決定に基づいています。以前の仕様では、1 月 1 日を含む週に、新しい年の日数が 4 日未満含まれている場合、その週は前年の第 53 週となっていました。しかし、ISO C9x 標準委員会によって、この仕様が正しくないと判断されました。

%g、%G、%Eg、%EG、%Og の変換仕様が Solaris 7 に追加されました。この変更は、現時点で公表されている ISO C9x 標準の決定に基づいています。これらの仕様は変更される可能性があります。ISO C9x 標準がこれらの仕様と異なる決定をした場合、仕様は ISO C9x 標準の決定に準拠して変更されます。

Solaris 8 リリースでは、%u の変換仕様が変更されました。この変更は、XPG4 仕様に基づいたものです。

%Z 指示子と zoneinfo タイムゾーンを使用している場合に、入力日時が 20:45:52 UTC, December 13, 1901 から 03:14:07 UTC, January 19, 2038 までの範囲外にある場合、タイムゾーン名が正しくないことがあります。

SunOS 5.10  最終更新日 2006 年 9 月 6 日

名前 | 形式 | 機能説明 | 戻り値 | 使用例 | 属性 | 関連項目 | 注意事項