frequency-generator
所属分类:其他
开发工具:PHP
文件大小:0KB
下载次数:0
上传日期:2023-12-23 17:59:32
上 传 者:
sh-1993
说明: 频率发生器
(frequency generator)
文件列表:
src/
tests/
.editorconfig
.php-cs-fixer.dist.php
LICENSE
composer.json
phpstan-baseline.neon
phpstan.neon.dist
phpunit.xml.dist
# Frequency generator
Get the next date (DateTime object) by frequency.
![Tests](https://github.com/e-commit/frequency-generator/workflows/Tests/badge.svg)
## Installation ##
To install frequency-generator with Composer just run :
```bash
$ composer require ecommit/frequency-generator
```
## Usage ##
### Create generator ###
```php
use Ecommit\FrequencyGenerator\FrequencyGenerator;
$generator = new FrequencyGenerator();
```
### Frequency "every day" ###
```php
//Every day at 08:00:00 and 10:00:00
$dateTimeObject = $generator->nextInEveryDay([new \DateTime('10:00:00'), new \DateTime('08:00:00')]);
```
Arguments :
* **array $times** Times (Array of DateTime or DateTimeImmutable objects). Default: only *00:00:00*
### Frequency "every week" ###
```php
//Every monday (at 08:00:00 and 10:00:00) and tuesday (at 08:00:00 and 10:00:00)
$dateTimeObject = $generator->nextInEveryWeek([1, 2], [new \DateTime('10:00:00'), new \DateTime('08:00:00')]);
```
Arguments :
* **array $days** Array of days in week (integers). (1=Monday => 7=Sunday). Default: Only *1* (monday)
* **array $times** Times (Array of DateTime or DateTimeImmutable objects). Default: only *00:00:00*
### Frequency "every month" ###
```php
//Every 1st (at 08:00:00 and 10:00:00) and 2nd (at 08:00:00 and 10:00:00)
$dateTimeObject = $generator->nextInEveryMonth([1, 2], [new \DateTime('10:00:00'), new \DateTime('08:00:00')]);
```
Arguments :
* **array $days** Array of days in month (integers). (1=>31). Default: Only *1* (1st)
* **array $times** Times (Array of DateTime or DateTimeImmutable objects). Default: only *00:00:00*
### Frequency "every quart" ###
```php
//Every 1st and 15th February, May, August and November (at 08:00:00 and 10:00:00)
$dateTimeObject = $generator->nextInEveryQuart([2], [1, 15], [new \DateTime('10:00:00'), new \DateTime('08:00:00')]);
```
Arguments :
* **array $monthOffsets** Array of month offsets in quart (integers). (1 = January, April, July, October. 2 = February, May, August, November. 3 = March, June, September, December). Default: Only *1* (January, April, July, October)
* **array $daysInMonth** Array of days in month (integers). (1=>31). Default: Only *1* (1st)
* **array $times** Times (Array of DateTime or DateTimeImmutable objects). Default: only *00:00:00*
### Frequency "every half year" ###
```php
//Every 1st and 15th February and August (at 08:00:00 and 10:00:00)
$dateTimeObject = $generator->nextInEveryHalfYear([2], [1, 15], [new \DateTime('10:00:00'), new \DateTime('08:00:00')]);
```
* **array $monthOffsets** Array of month offsets in half year (integers). 1 = January, July. 2 = February, August. 3 = March, September. 4 = April, October. 5 = May , November. 6 = June, December). Default: Only *1* (January, July)
* **array $daysInMonth** Array of days in month (integers). (1=>31). Default: Only *1* (1st)
* **array $times** Times (Array of DateTime or DateTimeImmutable objects). Default: only *00:00:00*
### Frequency "every year" ###
```php
//Every 1st and 15th January (at 08:00:00 and 10:00:00)
$dateTimeObject = $generator->nextInEveryYear([1], [1, 15], [new \DateTime('10:00:00'), new \DateTime('08:00:00')]);
```
* **array $monthOffsets** Array of month offsets in year (integers). (1 = January => 12 => December). Default: Only *1* (January)
* **array $daysInMonth** Array of days in month (integers). (1=>31). Default: Only *1* (1st)
* **array $times** Times (Array of DateTime or DateTimeImmutable objects). Default: only *00:00:00*
## Generate DateTimeImmutable objects ##
The generator generates by default DateTime objects.
The generator can generate DateTimeImmutable objets with `generateDateTimeImmutable` method:
```php
use Ecommit\FrequencyGenerator\FrequencyGenerator;
$generator = new FrequencyGenerator();
$date = $generator->nextInEveryDay([new \DateTime('10:00:00'), new \DateTime('08:00:00')]);
echo get_class($date); //This example will output "DateTime"
$generator->generateDateTimeImmutable(true);
$date = $generator->nextInEveryDay([new \DateTime('10:00:00'), new \DateTime('08:00:00')]);
echo get_class($date); //This example will output "DateTimeImmutable"
$generator->generateDateTimeImmutable(false);
$date = $generator->nextInEveryDay([new \DateTime('10:00:00'), new \DateTime('08:00:00')]);
echo get_class($date); //This example will output "DateTime"
```
## License ##
This librairy is under the MIT license. See the complete license in *LICENSE* file.
近期下载者:
相关文件:
收藏者: