smhg/date-frequency

Temporal frequency library

date-frequency-php

Temporal frequency library, _(*1)

PHP clone of JavaScript version., _(*2)

Installation

$ composer require smhg/date-frequency

Methods

Frequency

use Frequency\Frequency;

$frequency = new Frequency();
$frequency->on('day', 3, 'week')
    ->on('hour', 10)
    ->on('minute', 0)
    ->on('seconds', 0); // every Wednesday at 10:00:00

Frequency([string rules])

Frequency([array rules])

Pass rules as a string (see __toString) or an array to the constructor instead of setting them one-by-one with on()., _(*3)

Example above as a string: $frequency = new Frequency('F3D/WT10H0M0S');, _(*4)

on(string unit, int|string value, [string scope])

Add a rule (fixed integer value or a string representing the name of a filter function) to the frequency for a unit, optionally linked to a scope (if not provided, a default scope is derived)., _(*5)

Filter functions need to be available in the static Frequency::$fn array when used., _(*6)

Example filter: $frequency = new Frequency('F(leap)Y1M1DT0H0M0S'); (Jan 1st, at midnight, of leap years), _(*7)

See tests for more examples., _(*8)

next(DateTime start = new DateTime())

Get the next occurence of the frequency on or after a date., _(*9)

between(DateTime start, DateTime end)

Get all occurences of the frequency between 2 dates., _(*10)

__toString()

Convert frequency to a string value., _(*11)