The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

TL::DateTime - Date and time (ja)

NAME (ja)

TL::DateTime::JA - ��ヤ����������

SYNOPSIS

  my $dt = $TL->newDateTime('2006-02-17 15:18:01');
  $dt->addDay(1);
  $dt->addSecond(-1);
  print $dt->toStr('rfc822'); # Fri, 18 Feb 2006 15:18:00 JST

DESCRIPTION

��ヤ����������祉����宴����壔�í�鴻����違�㋘�眼�ŝ�ʋ⑳��˨�勉�水嚳綽������⓾��������膕上墾��夌����� ���������腱����紊���������������勉����ŝ�����

METHODS

$TL->newDateTime
  $dt = $TL->newDateTime;         # �憜�������
  $dt = $TL->newDateTime($str);   # ���絖������������若�

TL::DateTime ��ŝ����吾�с�壔�������������� 篋���ɾ�勉�勐就綣���с�壔�����絖������������ヤ����������祉�������若�鴻��������

絖���������ŝ����ヤ��������絎������������翫����壔�������������ɱ�������̬��罩c����������� 箴������井❶��� 2 茵���壠�����腟������˨�ŝ�����

  $dt = $TL->newDateTime('2000-04-31');
  $dt = $TL->newDateTime('2000-05-01');

篏�������罨<�勤����壔����若�鴻��紊掩�����������

  $dt = $TL->newDateTime('2000-99-99'); # 罩c�����綵√�����羃帥�c�⓾����ŝ��

�����若�鴻��紊掩����������翫�����die��������������祉��筝������������ŝ����翫����� 0 ��� 0 ��� 0腱� ��̬┃絎������������帥�ゃ����障�若�潟��筝���������ŝ����翫����� localtime ��� gmtime ��勐勲��� ���羆���������ゃ��荐㊤�������������������若�鴻�с�����綵√����壩❶��勰��������

筝����
 YYYY-MM-DD
 YYYY-MM-DD HH:MM:SS

�����ゃ����潟����潟�㏍�潟�壠�ャ�勤���垩�с����c�⓾����壔�����篏������<����⓾����壔����� 箴�:

 YYYY@MM@DD
 YYYY/MM/DD HH.MM.SS
 YYYYMMDD
 YYYYMMDDHHMMSS
date ��潟����潟��
 Wdy Mon DD HH:MM:SS TIMEZONE YYYY
 (Fri Feb 17 11:24:41 JST 2006)
Apache access_log
 DD/Mon/YYYY:HH:MM:SS +TTTT
 (17/Feb/2006:11:24:41 +0900)
Apache error_log
 Wdy Mon DD HH:MM:SS YYYY
 (Fri Feb 17 11:24:41 2006)
Apache directory index
 DD-Mon-YYYY HH:MM:SS
RFC 822
 Wdy, DD-Mon-YY HH:MM:SS TIMEZONE
 (Fri, 17 Feb 06 11:24:41 +0900)

 Wdy, DD-Mon-YYYY HH:MM:SS TIMEZONE
 (Fri, 17 Feb 2006 11:24:41 +0900)
RFC 850
 Wdy, DD-Mon-YY HH:MM:SS TIMEZONE
 (Fri, 17-Feb-06 11:24:41 JST)

 Wdy, DD-Mon-YYYY HH:MM:SS TIMEZONE
 (Fri, 17-Feb-2006 11:24:41 JST)
W3C Date and Time
 YYYY
 YYYY-MM
 YYYY-MM-DD
 YYYY-MM-DDTHH:MMTzd (2006-02-17T11:40+09:00)
 YYYY-MM-DDTHH:MM:SSTzd (2006-02-17T11:40:10+09:00)
 YYYY-MM-DDTHH:MM:SS.sTzd (2006-02-17T11:40:10.45+09:00)

��������� Tzd �����壔�帥�ゃ����障�若�恰��絎���с��������+hh:mm / -hh:mm / 'Z' ��勌�������� ��勐就綣���ц;������������Z ��� UTC ���茵�������箴�:

 2006-02-17T11:40:10Z

���緇���勐就綣���� .s ��壩����祉�勛ɵ��違��茵���������勉�с����������������勉�壔�í�鴻�勛仮綺⓾�夌���� ��������勉�с��腴壩�違�壔����若�劫����������������⓾�����������

TAI64N
 @4000000043f529721590b6bc

筝�腱���ʋ����壠����������⓾�����������

clone
  $dt2 = $dt->clone;

DateTime��ŝ����吾�с�壔�����茲�茖純����☀��������

set
  $dt->set;
  $dt->set($str);

綣���違�壔�潟�潟�鴻����í�壔�帥�����������

setEpoch
  $dt->setEpoch($epoch);

�����������壔�������勛����違��荐㊤����������������勉�壔�í�鴻�с����������壔����� gmtime(0) ��勤�� �����ヤ����������祉��篋�������莢���勐�ゃ��筝���������翫����壔�������������壚札�����勖�ヤ��/�����祉�̬┃ 絎�������������

setJulianDay
  $dt->setJulianDay($julian);

��⓾�ŝ�⓾�号�ャ��荐㊤�����������絨���違�ф��絎������������翫����壔�������勐�ゃ����������祉��羆����������

setYear
  $dt->setYear(2006);

綛眼��荐㊤�����������綣���違�壔���憜�◑┃絎���������⓾�������帥�ゃ����障�若�潟�с�勐�ゃ�������☀В������ ���������

setMonth
  $dt->setMonth(1);

������荐㊤�����������莢���勐�� n ���筝���������翫����壔�����紊у��(setMonth��勐�翫�����12) + 1 + n ���筝������������������勉�◑����ŝ�����箴������� setMonth(-1) ��� setMonth(12) ��̥�� ���������

綣���違��0��障�����13篁ヤ����с�������翫�����������-13篁ヤ����с�������翫����� die ���������

��障�����������紊���眼�����篋���˨�������ャ��絖����������膀���蚊�����紊���������翫����壔����ャ�����腟��� ��̬┃絎�������������箴�������1���31��ャ�� setMonth(4) ���������4���30��ャ�˨�ŝ�����

setDay
setHour
setMinute
setSecond

setMonth ������罕����莢���勐�ゃ��筝���������翫��膈���勐��篏���� setMonth ���羣����������

setTimeZone
  $dt->setTimeZone();         # localtime���gmtime��勐勲������荐�膊�
  $dt->setTimeZone(9);        # +09:00 ��̬┃絎�
  $dt->setTimeZone('+0900');  # +09:00 ��̬┃絎� (RFC 822)
  $dt->setTimeZone('+09:00'); # +09:00 ��̬┃絎� (W3C)
  $dt->setTimeZone('gmt');    # +00:00 ��̬┃絎�

��帥�ゃ����障�若�潟��荐㊤�������������帥�ゃ����障�若�潟��紊���眼�����������腟九嚳��������с�������������� ��夌�������⓾�ŝ�⓾�号�ャ�壠����������ŝ��������getSecond膈���ц�������������ヤ����������紫�����紊� ������������

getEpoch
  $epoch = $dt->getEpoch;

�����������夌�����菴������������������壚札�����勖�ヤ����������祉�с�虁����勐�ゃ��菴�������

getJulianDay
  $julian = $dt->getJulianDay;

��⓾�ŝ�⓾�号�ャ��絨���違�ц��������

getYear
  $year = $dt->getYear;

綛眼��菴��������憜�◑┃絎���������⓾�������帥�ゃ����障�若�潟�с�勐�ゃ��菴�������������

getMonth
  $mon = $dt->getMonth;       # ��医�� 1-12 ��ц��������

������菴�������

getDay
getHour
getMinute
getSecond

getYear������罕����

getWday
  $wday = $dt->getWday;       # ��医�� 0-6 ��ц��������0�����ユ�����1�����������с��������

�����ャ��菴���������医�� 0-6 ��ц��������0�����ユ�����1�����������с��������

getTimeZone
  $tz = $dt->getTimeZone();         # ��������ц�����

��帥�ゃ����障�若�潟�����������篏���ц��������腴壩�違����������翫����壠����違�ц��������

getAnimal
  $animal = $dt->getAnimal;      # ��医�� 0-11 ���菴����

�����勐拘��勐��篋���壔��菴�������0: 絖�, 1: 筝�, ... 11: 篋

getAllHolidays
  $hash = $dt->getAllHolidays;

�����勐拘��˨�������ユ�㋘�勛��腑㊥�ャ��菴�������菴������������ゃ�壔����㏍�若�� MM-DD 綵√����勖�ヤ����� ��ゃ��腑�腑㊥�ュ����勉�������激�ャ�с��������

isHoliday
  $bool = $dt->isHoliday;

�����勖�ャ����ユ�㋘�勛��腑㊥�ャ�с�������� 1 ��������������с�ŝ�������� undef ���菴�������

getHolidayName
  $str = $dt->getHolidayName;

�����勖�ャ��腑�腑㊥�ャ�с�������違����勐�������������������с�ŝ�������� undef ���菴�������

isLeapYear

�����勐拘������������綛眼�с�������� 1 ��������������с�ŝ�������� undef ���菴�������

getCalendar
  $array = $dt->getCalendar;

�����勖����勖�ユ�医����� DateTime ��ŝ����吾�с�壔�������ャ�c�����������菴�������

getCalendarMatrix
  $matrix = $dt->getCalendarMatrix(\$option);

�����勖����勉�˨�㋘�潟����若��篋�罨≦����������ц�������� 綣���違�壩❶��勰�����:

type

'normal' ��障����� 'fixed' ���2腮勰�����fixed ��˨�������◑����違����阪����˨�ŝ�����

begin

'sun' ��障����� 'mon' ���2腮勰�����sun ��ŝ����宴����ユ��������紮���障�����mon ��ŝ����������� ��������í�˨����� sun ���

��祉����ゃ�壔�˨�㋘�潟����若�勌��茵������� DateTime ��ŝ����吾�с�壔����勰��������1��倶�������主�����������������

spanSecond
  $seconds = $dt->spanSecond($dt2);

綣���違����勛����違�勐勲���荐�膊�������腟���������贋�違�ц��������綣���違�� DateTime ��ŝ����吾�с� ��������c����翫����壔����勉�ŝ����吾�с�壔�����罸�莠�������������篁ュ����勐�翫����壠����違�������勉�障�� $TL->newDateTime ���羝<����☎�������������ŝ����吾�с�壔�����罸�莠����������

菴������������ゃ�� (綣����) - (this) ��с��������綣���違������サ��ŝ����亥�������虁����˨�ŝ�����

spanMinute
spanHour
spanDay
spanMonth
spanYear

spanSecond ������罕����

addSecond
  $dt2 = $dt->addSecond($sec);

$sec 腱�緇���勖����祉��茵���� DateTime ��ŝ����吾�с�壔�������違����̥����������☀��������

addMinute
addHour
addDay

addSecond ������罕����

addMonth

addSecond ������罕����������������紊���翫����勖�ャ��紊���翫����勐拘/������絖���������ŝ�������勉� �����c����������ャ�壔����勖����勖��緇���勖�ャ��紊���眼�����������

addYear

addMonth ������罕����

nextDay

罨<�勖�ャ��茵���� DateTime ��ŝ����吾�с�壔�����菴�������

prevDay

�����勖�ャ��茵���� DateTime ��ŝ����吾�с�壔�����菴�������

firstDay

�����勖����勖�������勖�ャ��茵���� DateTime ��ŝ����吾�с�壔�����菴�������

lastDay

�����勖����勖��緇���勖�ャ��茵���� DateTime ��ŝ����吾�с�壔�����菴�������

toStr
  $str = $dt->toStr('mysql');  # YYYY-MM-DD HH:MM:SS ��勐就綣���ц��������
  $str = $dt->toStr('rfc822'); # rfc822 綵√����ц��������
  $str = $dt->toStr('rfc850'); # rfc850 綵√����ц��������
  $str = $dt->toStr('w3c');    # W3c Date and Time ��勐就綣���ц��������
  $str = $dt->toStr;           # mysql ������������

���絖������ц;��������ヤ����������祉��菴�������

strFormat
  $str = $dt->strFormat('%Y 綛� %m ��� %d ��� (%J) %H ��� %M ���');

���絎���������������í�若�����������緇���c�〠��絖������������������勉��菴�������

%a

��㊦軒��������������ャ�勐����� (Sun - Sat)

%A

絎������ʋ����ャ�勐����� (Sunday - Saturday)

%J

��ユ�㋝����с�勖����ャ�勐����� (��� - ���)

%b

��㊦軒��������������勐����� (Jan - Dec)

%B

絎������ʋ����勐����� (January - December)

%_B

��ユ�㋝����с�勖����勐����� (��〠�� - 絽̬軌)

%d

��ャ��2罅���ц;��� (01 - 31)

%_d

��� (1 - 31)

%m

������2罅���ц;��� (01-12)

%_m

��� (1-12)

%w

�����ャ��10��我�違�ц;�憗��0 - 6 ��с����ユ����� 0 ������������ 1 ���

%y

綛眼��筝�2罅���ц;��� (00 - 99)

%Y

綛眼��4罅���ц;�

%_Y

綛眼�������⓾�ц;�憗�� (綛恰��11綛� 膈�)

�����⓾�勐��臂í�������⓾����ŝ��膀���蚊�с�夌Ã���絖�������

%H

������24������茵◑�����2罅���ц;��� (00-23)

%_H

������24������茵◑����ц;��� (0-23)

%I

������12������茵◑�����2罅���ц;��� (00-11)

%_I

������12������茵◑����ц;��� (0-11)

%P

�����祉����������ŝ�� 'a.m.', ���緇���ŝ�� 'p.m.' ��̥舟������������ 24������茵◑����с��0���0�����壠��������������12���0�����壠��緇�������������

�����勉����帥�若�潟�� parseFormat ��т戎��������������壔��紊ф��絖����絨����絖���夌�∴����������� �����ŝ�ŝ����勖����<����∴��������������箴������� 'AM', 'A.M.', 'a.M' ��壔����������������� ��������⓾����若�鴻�����������

%_P

�����祉����������ŝ�� '������', ���緇���ŝ�� '���緇�' ��̥舟������������

%M

������2罅���ц;��� (00-59)

%_M

��� (0-59)

%S

腱����2罅���ц;��� (00-59)

%_S

腱� (0-59)

%E

���篋���壔��茵�������絖� (絖� - 篋�)

%z

RFC 822 綵√�������若�������帥�ゃ����障�若�潟��JST��勐�翫����� '+0900' ��˨�ŝ�����

%_z

W3C Date and Time 綵√�������若�������帥�ゃ����障�若�潟��JST��勐�翫����� '+09:00' ��˨�ŝ�����

%Z

��帥�ゃ����障�若�潟��茵�������腱違��絖���������ŝ����翫����夌Ã���絖������˨�ŝ�����

%T

'%H:%M:%S' ��勉����í�若����������ц��������������絖����

%%

'%' ������������絖�

parseFormat
  $dt->parseFormat('%Y %d %m', '2006 01 13');

���絎���������������í�若�������������������〠�ヤ����������祉�勖��絖������������若�鴻�������������í�若����� ������絖���� strFormat ��勉����勉�����筝���������í�若�����������絖����������綛眼��緇� ���篋������堺�ャ�ŝ����翫�������������若�鴻��紊掩����������翫����壔��die ���������

��障�����絽吾�̥Ã��純�障�����0��˨�����罅���������勖����<����◑�����茹���夌�∴�������☀В������������

12������茵◑����勖�������с����� %I ��� %_I ��������������障����壠��緇����茵���� %P ��� %_P ��壔�� ��������������������˨�壠�����筝≧�合�������������ŝ�������違�ŝ����ŝ����������������������鴻�������с� 罩g∈��ʋ����祉����ゃ����ŝ����冴��

SEE ALSO

TL

AUTHOR INFORMATION

    Copyright 2006 YMIRLINK Inc. All Rights Reserved.

    This framework is free software; you can redistribute it and/or modify it under the same terms as Perl itself

    �����勉����㋘�若����壔�若�壔�壔����ŝ�若�純�������⓾�с�≪�с����������ŝ����� Perl �����������í�ゃ�祉�潟�鴻�� �����у�����絽������喝����眼��茵���������������堺�ャ�障�����

    Address bug reports and comments to: tl@tripletail.jp

    HP : http://tripletail.jp/