getdate

Autres langues

Langue: ja

Version: 2001-12-26 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

̾Á°

getdate - ʸ»úÎó¤ò tm ¹½Â¤ÂΤËÊÑ´¹¤¹¤ë

½ñ¼°

#define _XOPEN_SOURCE
#define _XOPEN_SOURCE_EXTENDED
#include <time.h>

struct tm *getdate(const char *string);

extern int getdate_err;

#define _GNU_SOURCE
#include <time.h>

int getdate_r (const char *string, struct tm *res);

ÀâÌÀ

getdate() ´Ø¿ô¤Ï¡¢¥Ý¥¤¥ó¥¿ string ¤¬»Ø¤¹Ê¸»úÎó¤ò tm ¹½Â¤ÂΤËÊÑ´¹¤·¡¢¤½¤Î¹½Â¤ÂΤòÊÖ¤¹¡£ ¤³¤Î tm ¹½Â¤ÂΤÏÀÅŪ¤Ê¥á¥â¥êÎΰè¤Ë¤¢¤ë¤Î¤Ç¡¢ ¼¡¤Î¸Æ¤Ó½Ð¤·¤¬¹Ô¤ï¤ì¡¢¾å½ñ¤­¤µ¤ì¤Æ¤¤¤ë¤«¤â¤·¤ì¤Ê¤¤¡£

strptime(3) (format °ú¿ô¤ò¼è¤ë) ¤È¤ÏÂоÈŪ¤Ë¡¢ getdate() ¤Ï¥Õ¥¡¥¤¥ë¤Ë½ñ¤¤¤Æ¤¢¤ë¥Õ¥©¡¼¥Þ¥Ã¥È¤òÍѤ¤¤ë (¤³¤Î¥Õ¥¡¥¤¥ë¤Î¥Õ¥ë¥Ñ¥¹¤Ï DATEMSK ´Ä¶­ÊÑ¿ô¤ËÍ¿¤¨¤é¤ì¤Æ¤¤¤ë)¡£

¥Þ¥Ã¥Á¤ÎºÝ¤Ë¤ÏÂçʸ»ú¾®Ê¸»ú¤ò¶èÊ̤·¤Ê¤¤¡£ ¥Ñ¥¿¡¼¥óÃæ¤Ç¤âÊÑ´¹¤µ¤ì¤ëʸ»úÎóÃæ¤Ç¤â¡¢Í¾Ê¬¤Ê¶õÇòʸ»ú¤Ï̵»ë¤µ¤ì¤ë¡£

¥Ñ¥¿¡¼¥ó¤Ë»ØÄê¤Ç¤­¤ëÊÑ´¹»ØÄê¤Ï¡¢ strptime(3) ¤Î¤â¤Î¤ÈƱ¤¸¤Ç¤¢¤ë¡£¤¿¤À¤·¤Ò¤È¤ÄÊÑ´¹»ØÄ꤬Äɲ䵤ì¤Æ¤¤¤ë¡£

%Z
¥¿¥¤¥à¥¾¡¼¥ó¤Î̾Á°¡£

%Z ¤¬Í¿¤¨¤é¤ì¤ë¤È¡¢ÊÖ¤µ¤ì¤ëÃͤϡ¢¤½¤Î¥¿¥¤¥à¥¾¡¼¥ó¤Î¸½ºß»þ¹ï¤ËÂбþ¤¹¤ë Í×ÁÇÊ̤λþ¹ï (broken-down time) ¤Ë½é´ü²½¤µ¤ì¤ë¡£ Í¿¤¨¤é¤ì¤Æ¤¤¤Ê¤¤¤È¤­¤Ï¡¢¸½ºß¤Î¥í¡¼¥«¥ë¥¿¥¤¥à¤ËÂбþ¤¹¤ë Í×ÁÇÊ̤λþ¹ï¤Ë½é´ü²½¤µ¤ì¤ë¡£

ÍËÆü¤À¤±¤¬»ØÄꤵ¤ì¤¿¾ì¹ç¤Ï¡¢ º£Æü¤Þ¤¿¤Ïº£Æü°Ê¹ß¤Ç¡¢ ¤½¤ÎÍËÆü¤Ë¹çÃפ¹¤ëºÇ½é¤ÎÆü¤¬ºÎÍѤµ¤ì¤ë¡£

·î¤À¤±¤¬»ØÄꤵ¤ì¤¿¾ì¹ç (ǯ¤Î»ØÄê¤Ï¤Ê¤·) ¤Ï¡¢ º£·î¤Þ¤¿¤Ïº£·î°Ê¹ß¤Ç¡¢ ¤½¤Î·î¤Ë¹çÃפ¹¤ëºÇ½é¤Î·î¤¬ºÎÍѤµ¤ì¤ë¡£

»þ¡¦Ê¬¡¦É䬤¤¤º¤ì¤â»ØÄꤵ¤ì¤Ê¤«¤Ã¤¿¾ì¹ç¤Ï¡¢ ¸½ºß¤Î»þ¡¦Ê¬¡¦É䬺ÎÍѤµ¤ì¤ë¡£

ÆüÉդλØÄ꤬¤Ê¤«¤Ã¤¿¤¬¡¢»þ´Ö (hour) ¤À¤±»ØÄꤵ¤ì¤¿¾ì¹ç¤Ï¡¢ ¸½ºß¤Î»þ´Ö¤Þ¤¿¤Ï¤½¤ì°Ê¹ß¤Ç¡¢¤½¤Î»ØÄê¤Ë¹çÃפ¹¤ëºÇ½é¤Î»þ´Ö¤¬ºÎÍѤµ¤ì¤ë¡£

ÊÖ¤êÃÍ

À®¸ù¤¹¤ë¤È¡¢¤³¤Î´Ø¿ô¤Ï struct tm ¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£ ¼ºÇÔ¤¹¤ë¤È NULL ¤òÊÖ¤·¡¢¥°¥í¡¼¥Ð¥ëÊÑ¿ô getdate_err ¤òÀßÄꤹ¤ë¡£ errno ¤òÊѹ¹¤¹¤ë¤³¤È¤Ïµ¬Äꤵ¤ì¤Æ¤¤¤Ê¤¤¡£ getdate_err ¤Ë¤Ï°Ê²¼¤ÎÃͤ¬ÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
1
DATEMASK ´Ä¶­ÊÑ¿ô¤¬¶õ¤Þ¤¿¤Ï̤ÄêµÁ¤Ç¤¢¤ë¡£
2
¥Æ¥ó¥×¥ì¡¼¥È¥Õ¥¡¥¤¥ë¤òÆɤ߹þ¤ß¥ª¡¼¥×¥ó¤Ç¤­¤Ê¤¤¡£
3
¥Õ¥¡¥¤¥ë¥¹¥Æ¡¼¥¿¥¹¤Î¾ðÊ󤬼èÆÀ¤Ç¤­¤Ê¤¤¡£
4
¥Æ¥ó¥×¥ì¡¼¥È¥Õ¥¡¥¤¥ë¤¬Ä̾ï¤Î¥Õ¥¡¥¤¥ë¤Ç¤Ê¤¤¡£
5
¥Æ¥ó¥×¥ì¡¼¥È¥Õ¥¡¥¤¥ë¤ÎÆɤ߹þ¤ß»þ¤Ë¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¡£
6
¥á¥â¥ê¤Î³ä¤êÅö¤Æ¤Ë¼ºÇÔ¤·¤¿ (¥á¥â¥ê¤¬Â­¤ê¤Ê¤¤)¡£
7
ÆþÎϤ˥ޥåÁ¤·¤¿¥Õ¥¡¥¤¥ë¤Ë¡¢¹Ô¤¬´Þ¤Þ¤ì¤Æ¤¤¤Ê¤¤¡£
8
ÆþÎÏ»ØÄ꤬Àµ¤·¤¯¤Ê¤¤¡£

´Ä¶­ÊÑ¿ô

DATEMSK
½ñ¼°¥Ñ¥¿¡¼¥ó¤ò´Þ¤à¥Õ¥¡¥¤¥ë¡£
TZ, LC_TIME
strptime(3) ¤¬ÍѤ¤¤ëÊÑ¿ô¡£

½àµò

POSIX.1-2001

Ãí°Õ

getdate() ¤Ï getdate_err ¤òÍѤ¤¤Æ¤¤¤ë¤·¡¢ÀÅŪ¤Ê¥Ð¥Ã¥Õ¥¡¤Ë·ë²Ì¤òÊÖ¤¹¤Î¤Ç¡¢ ¥ê¥¨¥ó¥È¥é¥ó¥È¤Ç¤Ï¤Ê¤¤¡£ glibc ¤Ç¤ÏƱ¤¸µ¡Ç½¤ò»ý¤Ä¥¹¥ì¥Ã¥É¥»¡¼¥Õ¤Ê´Ø¿ô¤òÄ󶡤·¤Æ¤¤¤ë¡£ µ¡Ç½¤ÏƱ¤¸¤Ç¤¢¤ë¡£·ë²Ì¤Ï¥Ý¥¤¥ó¥¿ res ¤¬¼¨¤¹¥Ð¥Ã¥Õ¥¡¤ËÊÖ¤µ¤ì¡¢ ¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç¤Ë¤ÏÊÖ¤êÃͤ¬¥¼¥í°Ê³°¤È¤Ê¤ê¡¢¤³¤ì¤Ï¾åµ­¤ËÍ¿¤¨¤¿ getdate_err ¤ËÂФ¹¤ëÃͤÈƱ¤¸¤â¤Î¤Ë¤Ê¤ë¡£

POSIX.1-2001 »ÅÍͤˤª¤±¤ë strptime(3) ¤Ë¤Ï¡¢ %E ¤ä %O ¤È¤¤¤Ã¤¿½¤Àµ»Ò¤òÍѤ¤¤¿ÊÑ´¹»ØÄ꤬´Þ¤Þ¤ì¤Æ¤¤¤ë¡£ °ìÊý¤³¤Î»ÅÍÍ¤Ç¤Ï getdate() ¤Îµ­½Ò¤¬¤Ê¤¤¡£glibc ¤Î¼ÂÁõ¤Ç¤Ï getdate() ¤Ï strptime(3) ¤òÍѤ¤¤Æ¼ÂÁõ¤µ¤ì¤Æ¤¤¤ë¡£ ¤è¤Ã¤Æ¼«Æ°Åª¤ËÁ´¤¯Æ±¤¸ÊÑ´¹¤¬Î¾¼Ô¤Ç¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë¡£

glibc ¼ÂÁõ¤Ç¤Ï %Z ÊÑ´¹»ØÄê¤ò¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤Ê¤¤¡£

´ØÏ¢¹àÌÜ

localtime(3), setlocale(3), strftime(3), strptime(3), time(3), feature_test_macros(7)