https://github.com/thiagodp/tdatetime

⏰ Easy-to-used date and time extensions for PHP's DateTime class
https://github.com/thiagodp/tdatetime

date datetime php phputil time

Last synced: 1 day ago
JSON representation

⏰ Easy-to-used date and time extensions for PHP's DateTime class

• Host: GitHub
• URL: https://github.com/thiagodp/tdatetime
• Owner: thiagodp
• License: lgpl-3.0
• Created: 2015-01-24T22:40:43.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2022-12-18T17:22:08.000Z (almost 2 years ago)
• Last Synced: 2024-10-07T22:47:25.742Z (about 1 month ago)
• Topics: date, datetime, php, phputil, time
• Language: PHP
• Homepage:
• Size: 29.3 KB
• Stars: 4
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# TDateTime

[![Build Status](https://travis-ci.org/thiagodp/TDateTime.svg?branch=master)](https://travis-ci.org/thiagodp/TDateTime)

Easy-to-use date and time extensions for PHP's [DateTime](http://php.net/manual/en/class.datetime.php) class.

* No external dependencies.

* Unit-tested

* Semantic versioning

* PHP >= 5.2

## Installation

Installation via [Composer](https://getcomposer.org/):

```shell

composer require phputil/tdatetime

```

## Documentation

Available classes:

- [phputil\TDateTime](https://github.com/thiagodp/TDateTime/blob/master/lib/TDateTime.php) (extends PHP's `\DateTime`)

- [phputil\TDate](https://github.com/thiagodp/TDateTime/blob/master/lib/TDate.php) (extends `phputil\TDateTime`)

- [phputil\TTime](https://github.com/thiagodp/TDateTime/blob/master/lib/TTime.php) (extends `phputil\TDateTime`)

📖 [See the Wiki](https://github.com/thiagodp/TDateTime/wiki).

## Examples

```php

addOneDay();        // Adds one day

echo $dt1->day();         // 21

echo $dt1->dateString();  // 2015-01-21

echo $dt1->timeString();  // 09:10:55

// Clonnable

$dt2 = clone $dt1;

echo $dt2; // 2015-01-21 09:10:55

// Chainnable setter methods

$dt2->subYears( 1 )->addMonths( 11 )->setDay( 31 ); // 2014-12-31

// Allow to change the format for the current instance

$dt2->setLocalDateTimeFormat( TDateTime::AMERICAN_DATETIME_FORMAT );

echo $dt2; // 12/31/2014 09:10:55

// Allow to change the format of ALL instances, but respect local format modifications!

TDateTime::setGlobalDateTimeFormat( TDateTime::BRAZILIAN_DATETIME_FORMAT );

echo $dt1; // 21/01/2015 09:10:55 -> Brazilian datetime format

echo $dt2; // 12/31/2014 09:10:55 -> American datetime format (respect local formatting)

// Easy comparison

echo $dt2->before( $dt1 ); // true

echo $dt1->between( $dt2, new TDateTime() ); // true

echo $dt1->equalTo( $dt2 ) ? '=' : '!='; // !=

// Validation (version 1.1+)

echo $dt1->isValidDatabaseDate( '2000/01/31' ); // true

echo $dt1->isValidAmericanDate( '01/31/2000' ); // true

echo $dt1->isValidBrazilianDate( '31/01/2000' ); // true

echo $dt1->isValidDatabaseDateTime( '2000/01/31 23:59:59' ); // true

echo $dt1->isValidAmericanDateTime( '01/31/2000 23:59:59' ); // true

echo $dt1->isValidBrazilianDateTime( '31/01/2000 23:59:59' ); // true

echo $dt1->isValidTime( '23:59:59' ); // true

echo $dt1->isValidSimpleTime( '23:59' ); // true

?>

```

## License

[LGPL](LICENSE) © [Thiago Delgado Pinto](https://github.com/thiagodp)