role Dateish

Object that can be treated as a date

role Dateish { ... }

Both Date and DateTime support accessing a year, month and day-of-month, as well as related functionality such as calculating the day of the week.


method year

Defined as:

method year(Date:D: --> Int:D)

Returns the year of the date.

say'2015-12-31').year;                                  # OUTPUT: «2015␤» 
say =>'2015-12-24'), hour => 1).year# OUTPUT: «2015␤»

method month

Defined as:

method month(Date:D: --> Int:D)

Returns the month of the date (1..12).

say'2015-12-31').month;                                  # OUTPUT: «12␤» 
say =>'2015-12-24'), hour => 1).month# OUTPUT: «12␤»

method day

Defined as:

method day(Date:D: --> Int:D)

Returns the day of the month of the date (1..31).

say'2015-12-31').day;                                  # OUTPUT: «31␤» 
say =>'2015-12-24'), hour => 1).day# OUTPUT: «24␤»

method formatter

Defined as:

method formatter(Dateish:D:)

Returns the formatting function which is used for conversion to Str. If none was provided at object construction, a default formatter is used. In that case the method will return a Callable type object.

The formatting function is called by DateTime method Str with the invocant as its only argument.

my $dt ='2015-12-31');  # (no formatter specified) 
say $dt.formatter.^name;          # OUTPUT: «Callable␤» 
my $us-format = sub ($self{ sprintf "%02d/%02d/%04d" given $self};
$dt ='2015-12-31'formatter => $us-format);
say $dt.formatter.^name;           # OUTPUT: «Sub␤» 
say $dt;                          # OUTPUT: «12/31/2015␤»

method is-leap-year

Defined as:

method is-leap-year(--> Bool:D)

Returns True if the year of the Dateish object is a leap year.

say<2016>).is-leap-year# OUTPUT: «True␤» 
say"1900-01-01").is-leap-year;    # OUTPUT: «False␤»

method day-of-month

Defined as:

method day-of-month(Date:D: --> Int:D)

Returns the day of the month of the date (1..31). Synonymous to the day method.

say'2015-12-31').day-of-month;                                  # OUTPUT: «31␤» 
say =>'2015-12-24'), hour => 1).day-of-month# OUTPUT: «24␤»

method day-of-week

Defined as:

method day-of-week(Date:D: --> Int:D)

Returns the day of the week, where 1 is Monday, 2 is Tuesday and Sunday is 7.

say'2015-12-31').day-of-week;                                  # OUTPUT: «4␤» 
say =>'2015-12-24'), hour => 1).day-of-week# OUTPUT: «4␤»

method day-of-year

Defined as:

method day-of-year(Date:D: --> Int:D)

Returns the day of the year (1..366).

say'2015-12-31').day-of-year;                                  # OUTPUT: «365␤» 
say =>'2015-03-24'), hour => 1).day-of-year# OUTPUT: «83␤»

method days-in-month

Defined as:

method days-in-month(Dateish:D: --> Int:D)

Returns the number of days in the month represented by the Dateish object:

say"2016-01-02").days-in-month;                # OUTPUT: «31␤» 
say<10000>:month<2>).days-in-month# OUTPUT: «29␤»

method week

Defined as:

method week()

Returns a list of two integers: the year, and the week number. This is because at the start or end of a year, the week may actually belong to the other year.

my ($year$week="2014-12-31").week;
say $year;                       # OUTPUT: «2015␤» 
say $week;                       # OUTPUT: «1␤» 
say'2015-01-31').week# OUTPUT: «(2015 5)␤»

method week-number

Defined as:

method week-number(Date:D: --> Int:D)

Returns the week number (1..53) of the date specified by the invocant. The first week of the year is defined by ISO as the one which contains the fourth day of January. Thus, dates early in January often end up in the last week of the prior year, and similarly, the final few days of December may be placed in the first week of the next year.

say"2014-12-31").week-number;   # 1  (first week of 2015) 
say"2016-01-02").week-number;   # 53 (last week of 2015)

method week-year

Defined as:

method week-year(Date:D: --> Int:D)

Returns the week year of the date specified by the invocant. Normally week-year is equal to Date.year. Note however that dates early in January often end up in the last week of the prior year, and similarly, the final few days of December may be placed in the first week of the next year.

say"2015-11-15").week-year;   # 2015 
say"2014-12-31").week-year;   # 2015 (date belongs to the first week of 2015) 
say"2016-01-02").week-year;   # 2015 (date belongs to the last week of 2015)

method weekday-of-month

Defined as:

method weekday-of-month(Date:D: --> Int:D)

Returns a number (1..5) indicating the number of times a particular day-of-week has occurred so far during that month, the day itself included.

say"2003-06-09").weekday-of-month;  # 2  (second Monday of the month)

method yyyy-mm-dd

Defined as:

method yyyy-mm-dd(Date:D: --> Str:D)

Returns the date in YYYY-MM-DD format (ISO 8601)

say"2015-11-15").yyyy-mm-dd;   # OUTPUT: «2015-11-15␤» 
say OUTPUT: «2016-08-10␤» 

method daycount

Defined as:

method daycount(Dateish:D: --> Int:D)

Returns the number of days from the epoch Nov. 17, 1858 to the day of the invocant. The daycount returned by this method is the MJD, i.e. the Modified Julian Day, which is used routinely by e.g. astronomers, geodesists, scientists and others. The MJD convention is designed to facilitate simplified chronological calculations.

say'1995-09-27').daycount;    # OUTPUT: «49987␤»

method IO

Defined as:

method IO(Dateish:D: --> IO::Path:D)

Returns an IO::Path object representing the stringified value of the Dateish object:;   # OUTPUT: «"2016-10-03".IO␤» OUTPUT: «"2016-10-03T11:14:47.977994-04:00".IO␤»

PORTABILITY NOTE: some operating systems (e.g. Windows) do not permit colons (:) in filenames, which would be present in IO::Path created from a DateTime object.

Type Graph

Type relations for Dateish
perl6-type-graph Dateish Dateish Mu Mu Any Any Any->Mu Date Date Date->Dateish Date->Any DateTime DateTime DateTime->Dateish DateTime->Any

Expand above chart