Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/adrenalinkin/doctrine-utc-date-time

Provides Doctrine DBAL date and time types for storing in UTC format into database
https://github.com/adrenalinkin/doctrine-utc-date-time

doctrine-dbal doctrine-utc symfony-component utc-datetime

Last synced: about 15 hours ago
JSON representation

Provides Doctrine DBAL date and time types for storing in UTC format into database

Host: GitHub
URL: https://github.com/adrenalinkin/doctrine-utc-date-time
Owner: adrenalinkin
License: mit
Created: 2018-02-14T16:18:20.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2023-06-04T15:41:13.000Z (over 1 year ago)
Last Synced: 2024-09-20T08:33:46.597Z (5 days ago)
Topics: doctrine-dbal, doctrine-utc, symfony-component, utc-datetime
Language: PHP
Homepage:
Size: 17.6 KB
Stars: 5
Watchers: 1
Forks: 3
Open Issues: 2
Metadata Files:
- Readme: README.RU.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

Doctrine UTC Date Time [![In English](https://img.shields.io/badge/Switch_To-English-green.svg?style=flat-square)](./README.md)
======================

[![PHPUnit](https://github.com/adrenalinkin/doctrine-utc-date-time/workflows/UnitTests/badge.svg)](https://github.com/adrenalinkin/doctrine-utc-date-time/actions/workflows/unit-tests.yml)
[![Coverage Status](https://coveralls.io/repos/github/adrenalinkin/doctrine-utc-date-time/badge.svg?branch=master)](https://coveralls.io/github/adrenalinkin/doctrine-utc-date-time?branch=master)
[![Latest Stable Version](https://poser.pugx.org/adrenalinkin/doctrine-utc-date-time/v/stable)](https://packagist.org/packages/adrenalinkin/doctrine-utc-date-time)
[![Total Downloads](https://poser.pugx.org/adrenalinkin/doctrine-utc-date-time/downloads)](https://packagist.org/packages/adrenalinkin/doctrine-utc-date-time)

Введение
--------

Компонент содержит набор `DBAL` типов времени и даты, которые регистрируются как тип данных `Doctrine`.
Зарегистрированные типы `DBAL` обеспечивают хранение данных даты и времени в базе данных в формате `UTC`.
В состав входят три типа:

* [UtcDateTimeType.php](DBAL/Types/UtcDateTimeType.php) - для хранения в `UTC` формате даты и времени.
* [UtcDateType.php](DBAL/Types/UtcDateType.php) - для хранения в `UTC` формате даты.
* [UtcTimeType.php](DBAL/Types/UtcTimeType.php) - для хранения в `UTC` формате времени.

Установка
---------

Откройте консоль и, перейдя в директорию проекта, выполните следующую команду для загрузки наиболее подходящей
стабильной версии этого компонента:
```bash
composer require adrenalinkin/doctrine-utc-date-time
```
*Эта команда подразумевает что [Composer](https://getcomposer.org) установлен и доступен глобально.*

Пример использования
--------------------

Для регистрации нового типа данных `Doctrine` необходимо воспользоваться инструкцией, описанной в официальной
документации Symfony [How to Use Doctrine DBAL](https://symfony.com/doc/current/doctrine/dbal.html).

Таким образом, чтобы зарегистрировать новые типы, которые хранят дату и время в `UTC` необходимо добавить
следующую конфигурацию:

```yaml
# app/config/config.yml
doctrine:
dbal:
types:
utc_date: Linkin\Component\DoctrineUTCDateTime\DBAL\Types\UtcDateType
utc_datetime: Linkin\Component\DoctrineUTCDateTime\DBAL\Types\UtcDateTimeType
utc_time: Linkin\Component\DoctrineUTCDateTime\DBAL\Types\UtcTimeType
```

Также можно переопределить существующие типы хранения времени и даты, добившись автоматического хранения всех дат в
формате `UTC`. Для этого нужно добавить следующие строки в конфигурацию проекта:

```yaml
# app/config/config.yml
doctrine:
dbal:
types:
date: Linkin\Component\DoctrineUTCDateTime\DBAL\Types\UtcDateType
datetime: Linkin\Component\DoctrineUTCDateTime\DBAL\Types\UtcDateTimeType
time: Linkin\Component\DoctrineUTCDateTime\DBAL\Types\UtcTimeType
```

Лицензия
--------

[![license](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](./LICENSE)