Civil Date PHP Package

DayOfWeek : int
in package

Represents a civil day of week.

Integer values follow PHP's date('w') convention: Sunday is 0 and Saturday is 6.

Table of Contents

Cases

Friday  = 5
Friday.
Monday  = 1
Monday.
Saturday  = 6
Saturday.
Sunday  = 0
Sunday.
Thursday  = 4
Thursday.
Tuesday  = 2
Tuesday.
Wednesday  = 3
Wednesday.

Methods

countOccurrences()  : int
Counts occurrences of this day of week in an inclusive Julian Day Number range.
daysSince()  : int
Returns the number of days from this day of week to a past occurrence of another day of week.
daysUntil()  : int
Returns the number of days from this day of week to a future occurrence of another day of week.
fromJDN()  : self
Returns the day of week for a Julian Day Number.
weeksSpanned()  : int
Returns the number of weeks spanned by a day count starting from this day of week.

Cases

Methods

countOccurrences()

Counts occurrences of this day of week in an inclusive Julian Day Number range.

public countOccurrences(int $startJDN, int $endJDN) : int
Parameters
$startJDN : int

Inclusive start Julian Day Number.

$endJDN : int

Inclusive end Julian Day Number.

Tags
throws
InvalidArgumentException

If the range start is after the range end.

Return values
int

Number of matching days of week in the range.

daysSince()

Returns the number of days from this day of week to a past occurrence of another day of week.

public daysSince(self $dayOfWeek[, int $occurrence = 1 ]) : int
Parameters
$dayOfWeek : self

Target day of week to look back to.

$occurrence : int = 1

Which occurrence of the target day of week.

Tags
throws
InvalidArgumentException

If the occurrence is less than 1.

Return values
int

Number of days since the requested occurrence.

daysUntil()

Returns the number of days from this day of week to a future occurrence of another day of week.

public daysUntil(self $dayOfWeek[, int $occurrence = 1 ]) : int
Parameters
$dayOfWeek : self

Target day of week to look forward to.

$occurrence : int = 1

Which occurrence of the target day of week.

Tags
throws
InvalidArgumentException

If the occurrence is less than 1.

Return values
int

Number of days to the requested occurrence.

fromJDN()

Returns the day of week for a Julian Day Number.

public static fromJDN(int $jdn) : self
Parameters
$jdn : int

Julian Day Number.

Return values
self

Day of week for the given Julian Day Number.

weeksSpanned()

Returns the number of weeks spanned by a day count starting from this day of week.

public weeksSpanned(int $days, self $firstDayOfWeek) : int
Parameters
$days : int

The number of days in the span, starting from this day of week.

$firstDayOfWeek : self

Day of week considered as the start of the week for counting purposes.

Tags
throws
InvalidArgumentException

If the number of days is less than 1.

Return values
int

Number of weeks spanned by the day count.

On this page

Search results