vendor

vendor/cakephp/chronos/docs/config/all.py

@@ -0,0 +1,46 @@
+# Global configuration information used across all the
+# translations of documentation.
+#
+# Import the base theme configuration
+from cakephpsphinx.config.all import *
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+
+# The full version, including alpha/beta/rc tags.
+release = '1.x'
+
+# The search index version.
+search_version = 'chronos-1'
+
+# The marketing display name for the book.
+version_name = ''
+
+# Project name shown in the black header bar
+project = 'Chronos'
+
+# Other versions that display in the version picker menu.
+version_list = [
+    {'name': '1.x', 'number': '/chronos/1.x', 'title': '1.x', 'current': True},
+]
+
+# Languages available.
+languages = ['en', 'fr', 'ja', 'pt']
+
+# The GitHub branch name for this version of the docs
+# for edit links to point at.
+branch = 'master'
+
+# Current version being built
+version = '1.x'
+
+# Language in use for this directory.
+language = 'en'
+
+show_root_link = True
+
+repository = 'cakephp/chronos'
+
+source_path = 'docs/'

vendor/cakephp/chronos/docs/en/conf.py

@@ -0,0 +1,9 @@
+import sys, os
+
+# Append the top level directory of the docs, so we can import from the config dir.
+sys.path.insert(0, os.path.abspath('..'))
+
+# Pull in all the configuration options defined in the global config file..
+from config.all import *
+
+language = 'en'

vendor/cakephp/chronos/docs/en/contents.rst

@@ -0,0 +1,7 @@
+.. toctree::
+    :maxdepth: 2
+    :caption: CakePHP Chronos
+
+    /index
+
+    API <https://api.cakephp.org/chronos>

vendor/cakephp/chronos/docs/en/index.rst

@@ -0,0 +1,313 @@
+Chronos
+#######
+
+Chronos provides a zero-dependency collection of extensions to the ``DateTime``
+object. In addition to convenience methods, Chronos provides:
+
+* ``Date`` objects for representing calendar dates.
+* Immutable date and datetime objects.
+* A pluggable translation system. Only English translations are included in the
+  library. However, ``cakephp/i18n`` can be used for full language support.
+
+Installation
+------------
+
+To install Chronos, you should use ``composer``. From your
+application's ROOT directory (where composer.json file is located) run the
+following::
+
+    php composer.phar require cakephp/chronos "@stable"
+
+Overview
+--------
+
+Chronos provides a number of extensions to the DateTime objects provided by PHP.
+Chronos provides 5 classes that cover mutable and immutable date/time variants
+and extensions to ``DateInterval``.
+
+* ``Cake\Chronos\Chronos`` is an immutable *date and time* object.
+* ``Cake\Chronos\Date`` is a immutable *date* object.
+* ``Cake\Chronos\MutableDateTime`` is a mutable *date and time* object.
+* ``Cake\Chronos\MutableDate`` is a mutable *date* object.
+* ``Cake\Chronos\ChronosInterval`` is an extension to the ``DateInterval``
+  object.
+
+Lastly, if you want to typehint against Chronos-provided date/time objects you
+should use ``Cake\Chronos\ChronosInterface``. All of the date and time objects
+implement this interface.
+
+Creating Instances
+------------------
+
+There are many ways to get an instance of Chronos or Date. There are a number of
+factory methods that work with different argument sets::
+
+    use Cake\Chronos\Chronos;
+
+    $now = Chronos::now();
+    $today = Chronos::today();
+    $yesterday = Chronos::yesterday();
+    $tomorrow = Chronos::tomorrow();
+
+    // Parse relative expressions
+    $date = Chronos::parse('+2 days, +3 hours');
+
+    // Date and time integer values.
+    $date = Chronos::create(2015, 12, 25, 4, 32, 58);
+
+    // Date or time integer values.
+    $date = Chronos::createFromDate(2015, 12, 25);
+    $date = Chronos::createFromTime(11, 45, 10);
+
+    // Parse formatted values.
+    $date = Chronos::createFromFormat('m/d/Y', '06/15/2015');
+
+Working with Immutable Objects
+------------------------------
+
+If you've used PHP's ``DateTime`` objects, you're comfortable with *mutable*
+objects. Chronos offers mutable objects, but it also provides *immutable*
+objects. Immutable objects create copies of objects each time an object is
+modified. Because modifier methods around datetimes are not always transparent,
+data can be modified accidentally or without the developer knowing.
+Immutable objects prevent accidental changes to
+data, and make code free of order-based dependency issues. Immutability
+does mean that you will need to remember to replace variables when using
+modifiers::
+
+    // This code doesn't work with immutable objects
+    $time->addDay(1);
+    doSomething($time);
+    return $time;
+
+    // This works like you'd expect
+    $time = $time->addDay(1);
+    $time = doSomething($time);
+    return $time;
+
+By capturing the return value of each modification your code will work as
+expected. If you ever have an immutable object, and want to create a mutable
+one, you can use ``toMutable()``::
+
+    $inplace = $time->toMutable();
+
+Date Objects
+------------
+
+PHP only provides a single DateTime object. Representing calendar dates can be
+a bit awkward with this class as it includes timezones, and time components that
+don't really belong in the concept of a 'day'. Chronos provides a ``Date``
+object that allows you to represent dates. The time and timezone for these
+objects is always fixed to ``00:00:00 UTC`` and all formatting/difference
+methods operate at the day resolution::
+
+    use Cake\Chronos\Date;
+
+    $today = Date::today();
+
+    // Changes to the time/timezone are ignored.
+    $today->modify('+1 hours');
+
+    // Outputs '2015-12-20'
+    echo $today;
+
+Modifier Methods
+----------------
+
+Chronos objects provide modifier methods that let you modify the value in
+a granular way::
+
+    // Set components of the datetime value.
+    $halloween = Date::create()
+        ->year(2015)
+        ->month(10)
+        ->day(31)
+        ->hour(20)
+        ->minute(30);
+
+You can also modify parts of a date relatively::
+
+    $future = Date::create()
+        ->addYear(1)
+        ->subMonth(2)
+        ->addDays(15)
+        ->addHours(20)
+        ->subMinutes(2);
+
+It is also possible to make big jumps to defined points in time::
+
+    $time = Chronos::create();
+    $time->startOfDay();
+    $time->endOfDay();
+    $time->startOfMonth();
+    $time->endOfMonth();
+    $time->startOfYear();
+    $time->endOfYear();
+    $time->startOfWeek();
+    $time->endOfWeek();
+
+Or jump to specific days of the week::
+
+    $time->next(ChronosInterface::TUESDAY);
+    $time->previous(ChronosInterface::MONDAY);
+
+When modifying dates/times across :abbr:`DST (Daylight Savings Time)` transitions
+your operations may gain/lose an additional hours resulting in hour values that
+don't add up. You can avoid these issues by first changing your timezone to
+``UTC``, modifying the time::
+
+    // Additional hour gained.
+    $time = new Chronos('2014-03-30 00:00:00', 'Europe/London');
+    debug($time->modify('+24 hours')); // 2014-03-31 01:00:00
+
+    // First switch to UTC, and modify
+    $time = $time->setTimezone('UTC')
+        ->modify('+24 hours');
+
+Once you are done modifying the time you can add the original timezone to get
+the localized time.
+
+Comparison Methods
+------------------
+
+Once you have 2 instances of Chronos date/time objects you can compare them in
+a variety of ways::
+
+    // Full suite of comparators exist
+    // ne, gt, lt, lte.
+    $first->eq($second);
+    $first->gte($second);
+
+    // See if the current object is between two others.
+    $now->between($start, $end);
+
+    // Find which argument is closest or farthest.
+    $now->closest($june, $november);
+    $now->farthest($june, $november);
+
+You can also inquire about where a given value falls on the calendar::
+
+    $now->isToday();
+    $now->isYesterday();
+    $now->isFuture();
+    $now->isPast();
+
+    // Check the day of the week
+    $now->isWeekend();
+
+    // All other weekday methods exist too.
+    $now->isMonday();
+
+You can also find out if a value was within a relative time period::
+
+    $time->wasWithinLast('3 days');
+    $time->isWithinNext('3 hours');
+
+Generating Differences
+----------------------
+
+In addition to comparing datetimes, calculating differences or deltas between
+two values is a common task::
+
+    // Get a DateInterval representing the difference
+    $first->diff($second);
+
+    // Get difference as a count of specific units.
+    $first->diffInHours($second);
+    $first->diffInDays($second);
+    $first->diffInWeeks($second);
+    $first->diffInYears($second);
+
+You can generate human readable differences suitable for use in a feed or
+timeline::
+
+    // Difference from now.
+    echo $date->diffForHumans();
+
+    // Difference from another point in time.
+    echo $date->diffForHumans($other); // 1 hour ago;
+
+Formatting Strings
+------------------
+
+Chronos provides a number of methods for displaying our outputting datetime
+objects::
+
+    // Uses the format controlled by setToStringFormat()
+    echo $date;
+
+    // Different standard formats
+    echo $time->toAtomString();      // 1975-12-25T14:15:16-05:00
+    echo $time->toCookieString();    // Thursday, 25-Dec-1975 14:15:16 EST
+    echo $time->toIso8601String();   // 1975-12-25T14:15:16-05:00
+    echo $time->toRfc822String();    // Thu, 25 Dec 75 14:15:16 -0500
+    echo $time->toRfc850String();    // Thursday, 25-Dec-75 14:15:16 EST
+    echo $time->toRfc1036String();   // Thu, 25 Dec 75 14:15:16 -0500
+    echo $time->toRfc1123String();   // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toRfc2822String();   // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toRfc3339String();   // 1975-12-25T14:15:16-05:00
+    echo $time->toRssString();       // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toW3cString();       // 1975-12-25T14:15:16-05:00
+
+    // Get the quarter/week
+    echo $time->toQuarter();         // 4
+    echo $time->toWeek();            // 52
+
+    // Generic formatting
+    echo $time->toTimeString();           // 14:15:16
+    echo $time->toDateString();           // 1975-12-25
+    echo $time->toDateTimeString();       // 1975-12-25 14:15:16
+    echo $time->toFormattedDateString();  // Dec 25, 1975
+    echo $time->toDayDateTimeString();    // Thu, Dec 25, 1975 2:15 PM
+
+Extracting Date Components
+--------------------------
+
+Getting parts of a date object can be done by directly accessing properties::
+
+    $time = new Chronos('2015-12-31 23:59:58');
+    $time->year;    // 2015
+    $time->month;   // 12
+    $time->day;     // 31
+    $time->hour     // 23
+    $time->minute   // 59
+    $time->second   // 58
+
+Other properties that can be accessed are:
+
+- timezone
+- timezoneName
+- micro
+- dayOfWeek
+- dayOfMonth
+- dayOfYear
+- daysInMonth
+- timestamp
+- quarter
+
+Testing Aids
+------------
+
+When writing unit tests, it is helpful to fixate the current time. Chronos lets
+you fix the current time for each class. As part of your test suite's bootstrap
+process you can include the following::
+
+    Chronos::setTestNow(Chronos::now());
+    MutableDateTime::setTestNow(MutableDateTime::now());
+    Date::setTestNow(Date::now());
+    MutableDate::setTestNow(MutableDate::now());
+
+This will fix the current time of all objects to be the point at which the test
+suite started.
+
+For example, if you fixate the ``Chronos`` to some moment in the past, any new
+instance of ``Chronos`` created with ``now`` or a relative time string, will be
+returned relative to the fixated time::
+
+    Chronos::setTestNow(new Chronos('1975-12-25 00:00:00'));
+
+    $time = new Chronos(); // 1975-12-25 00:00:00
+    $time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00
+
+To reset the fixation, simply call ``setTestNow()`` again with no parameter or
+with ``null`` as a parameter.

vendor/cakephp/chronos/docs/fr/conf.py

@@ -0,0 +1,9 @@
+import sys, os
+
+# Append the top level directory of the docs, so we can import from the config dir.
+sys.path.insert(0, os.path.abspath('..'))
+
+# Pull in all the configuration options defined in the global config file..
+from config.all import *
+
+language = 'fr'

vendor/cakephp/chronos/docs/fr/contents.rst

@@ -0,0 +1,7 @@
+.. toctree::
+    :maxdepth: 2
+    :caption: CakePHP Chronos
+
+    /index
+
+    API <https://api.cakephp.org/chronos>

vendor/cakephp/chronos/docs/fr/index.rst

@@ -0,0 +1,306 @@
+Chronos
+#######
+
+Chronos fournit une collection d'extensions sans aucune dépendance pour l'objet
+``DateTime``. En plus de méthodes pratiques, Chronos fournit:
+
+* Des objets ``Date`` pour représenter les dates du calendrier.
+* Des objets immutables pour les dates et les datetimes.
+* Un système de traduction intégrable. Seules les traductions anglaises sont
+  inclues dans la librairie. Cependant, ``cakephp/i18n`` peut être utilisé
+  pour un support complet d'autres langues.
+
+Installation
+------------
+
+Pour installer Chronos, vous devez utiliser ``composer``. A partir du répertoire
+ROOT de votre application (où le fichier composer.json se trouve) exécutez ce
+qui suit::
+
+    php composer.phar require cakephp/chronos "@stable"
+
+Vue d'Ensemble
+--------------
+
+Chronos fournit un certain nombre d'extensions pour les objets DateTime fournis
+par PHP. Chronos fournit 5 classes qui gèrent les variantes mutables et
+immutables de date/time et les extensions de ``DateInterval``.
+
+* ``Cake\Chronos\Chronos`` est un objet de *date et time* immutable.
+* ``Cake\Chronos\Date`` est un objet de *date* immutable.
+* ``Cake\Chronos\MutableDateTime`` est un objet de *date et time* mutable.
+* ``Cake\Chronos\MutableDate`` est un objet de *date* mutable.
+* ``Cake\Chronos\ChronosInterval`` est une extension pour l'objet
+  ``DateInterval``.
+
+Enfin si vous voulez typer selon les objets date/time fournis par Chronos,
+vous devez utiliser ``Cake\Chronos\ChronosInterface``. Tous les objets date et
+time implémentent cette interface.
+
+Créer des Instances
+-------------------
+
+Il y a plusieurs façons d'obtenir une instance de Chronos ou de Date. Il y a
+un certain nombre de méthodes factory qui fonctionnent avec des ensembles
+ayant des arguments différents::
+
+    use Cake\Chronos\Chronos;
+
+    $now = Chronos::now();
+    $today = Chronos::today();
+    $yesterday = Chronos::yesterday();
+    $tomorrow = Chronos::tomorrow();
+
+    // Parse les expressions relatives
+    $date = Chronos::parse('+2 days, +3 hours');
+
+    // Les valeurs d'entier de Date et time.
+    $date = Chronos::create(2015, 12, 25, 4, 32, 58);
+
+    // Les valeurs d'entier pour Date ou time.
+    $date = Chronos::createFromDate(2015, 12, 25);
+    $date = Chronos::createFromTime(11, 45, 10);
+
+    // Parse les valeurs formatées.
+    $date = Chronos::createFromFormat('m/d/Y', '06/15/2015');
+
+Travailler avec les Objets Immutables
+-------------------------------------
+
+Si vous avez utilisé les objets ``DateTime`` de PHP, vous êtes à l'aise avec
+les objets *mutable*. Chronos offre des objets mutables, mais elle fournit
+également des objets *immutables*. Les objets Immutables créent des copies des
+objets à chaque fois qu'un objet est modifié. Puisque les méthodes de
+modification autour des datetimes ne sont pas toujours transparentes, les
+données peuvent être modifiées accidentellement ou sans que le développeur ne
+le sache. Les objets immutables évitent les changements accidentels des
+données et permettent de s'affranchir de tout problème lié à l'ordre d'appel
+des fonctions ou des dépendances. L'immutabilité signifie que vous devez vous
+souvenir de remplacer les variables quand vous utilisez les modificateurs::
+
+    // Ce code ne fonctionne pas avec les objets immutables
+    $time->addDay(1);
+    doSomething($time);
+    return $time;
+
+    // Ceci fonctionne comme vous le souhaitez
+    $time = $time->addDay(1);
+    $time = doSomething($time);
+    return $time;
+
+En capturant la valeur de retour pour chaque modification, votre code
+fonctionnera comme souhaité. Si vous avez déjà créé un objet immutable, et que
+vous souhaitez un objet mutable, vous pouvez utiliser ``toMutable()``::
+
+    $inplace = $time->toMutable();
+
+Objets Date
+-----------
+
+PHP fournit seulement un unique objet DateTime. Représenter les dates de
+calendrier peut être un peu gênant avec cette classe puisqu'elle inclut les
+timezones, et les composants de time qui n'appartiennent pas vraiment
+dans le concept d'un 'jour'. Chronos fournit un objet ``Date`` qui vous permet
+de représenter les dates. Les time et timezone pour ces objets sont toujours
+fixés à ``00:00:00 UTC`` et toutes les méthodes de formatage/différence
+fonctionnent au niveau du jour::
+
+    use Cake\Chronos\Date;
+
+    $today = Date::today();
+
+    // Changements selon le time/timezone sont ignorés.
+    $today->modify('+1 hours');
+
+    // Affiche '2015-12-20'
+    echo $today;
+
+Méthodes de Modification
+------------------------
+
+Les objets Chronos fournissent des méthodes de modification qui vous laissent
+modifier la valeur d'une façon assez précise::
+
+    // Définit les composants de la valeur du datetime.
+    $halloween = Date::create()
+        ->year(2015)
+        ->month(10)
+        ->day(31)
+        ->hour(20)
+        ->minute(30);
+
+Vous pouvez aussi modifier les parties de la date de façon relative::
+
+    $future = Date::create()
+        ->addYear(1)
+        ->subMonth(2)
+        ->addDays(15)
+        ->addHours(20)
+        ->subMinutes(2);
+
+Il est  également possible de faire des sauts vers des points définis dans le
+temps::
+
+    $time = Chronos::create();
+    $time->startOfDay();
+    $time->endOfDay();
+    $time->startOfMonth();
+    $time->endOfMonth();
+    $time->startOfYear();
+    $time->endOfYear();
+    $time->startOfWeek();
+    $time->endOfWeek();
+
+Ou de sauter à un jour spécifique de la semaine::
+
+    $time->next(ChronosInterface::TUESDAY);
+    $time->previous(ChronosInterface::MONDAY);
+
+Méthodes de Comparaison
+-----------------------
+
+Une fois que vous avez 2 instances d'objets date/time de Chronos, vous pouvez
+les comparer de plusieurs façons::
+
+    // Suite complète de comparateurs existante
+    // ne, gt, lt, lte.
+    $first->eq($second);
+    $first->gte($second);
+
+    // Regardez si l'objet courant est entre deux autres.
+    $now->between($start, $end);
+
+    // Trouver l'argument le plus proche ou le plus éloigné.
+    $now->closest($june, $november);
+    $now->farthest($june, $november);
+
+Vous pouvez aussi vous renseigner sur le moment où une valeur donnée tombe dans
+le calendrier::
+
+    $now->isToday();
+    $now->isYesterday();
+    $now->isFuture();
+    $now->isPast();
+
+    // Vérifie le jour de la semaine
+    $now->isWeekend();
+
+    // Toutes les autres méthodes des jours de la semaine existent aussi.
+    $now->isMonday();
+
+Vous pouvez aussi trouver si une valeur était dans une période de temps relative::
+
+    $time->wasWithinLast('3 days');
+    $time->isWithinNext('3 hours');
+
+Générer des Différences
+-----------------------
+
+En plus de comparer les datetimes, calculer les différences ou les deltas entre
+des valeurs est une tâche courante::
+
+    // Récupère un DateInterval représentant la différence
+    $first->diff($second);
+
+    // Récupère la différence en tant que nombre d'unités spécifiques.
+    $first->diffInHours($second);
+    $first->diffInDays($second);
+    $first->diffInWeeks($second);
+    $first->diffInYears($second);
+
+Vous pouvez générer des différences lisibles qui peuvent vous servir pour
+l'utilisation d'un feed ou d'une timeline::
+
+    // Différence à partir de maintenant.
+    echo $date->diffForHumans();
+
+    // Différence à partir d'un autre point du temps.
+    echo $date->diffForHumans($other); // 1 hour ago;
+
+Formater les Chaînes
+--------------------
+
+Chronos fournit un certain nombre de méthodes pour afficher nos sorties d'objets
+datetime::
+
+    // Utilise le format contrôlé par setToStringFormat()
+    echo $date;
+
+    // Différents formats standards
+    echo $time->toAtomString();      // 1975-12-25T14:15:16-05:00
+    echo $time->toCookieString();    // Thursday, 25-Dec-1975 14:15:16 EST
+    echo $time->toIso8601String();   // 1975-12-25T14:15:16-05:00
+    echo $time->toRfc822String();    // Thu, 25 Dec 75 14:15:16 -0500
+    echo $time->toRfc850String();    // Thursday, 25-Dec-75 14:15:16 EST
+    echo $time->toRfc1036String();   // Thu, 25 Dec 75 14:15:16 -0500
+    echo $time->toRfc1123String();   // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toRfc2822String();   // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toRfc3339String();   // 1975-12-25T14:15:16-05:00
+    echo $time->toRssString();       // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toW3cString();       // 1975-12-25T14:15:16-05:00
+
+    // Récupère le trimestre
+    echo $time->toQuarter();         // 4;
+    // Récupère la semaine
+    echo $time->toWeek();            // 52;
+
+    // Formatage générique
+    echo $time->toTimeString();           // 14:15:16
+    echo $time->toDateString();           // 1975-12-25
+    echo $time->toDateTimeString();       // 1975-12-25 14:15:16
+    echo $time->toFormattedDateString();  // Dec 25, 1975
+    echo $time->toDayDateTimeString();    // Thu, Dec 25, 1975 2:15 PM
+
+Extraire des Fragments de Date
+------------------------------
+
+Il est possible de récupérer des parties d'un objet date en accédant directement
+à ses propriétés::
+
+    $time = new Chronos('2015-12-31 23:59:58');
+    $time->year;    // 2015
+    $time->month;   // 12
+    $time->day;     // 31
+    $time->hour     // 23
+    $time->minute   // 59
+    $time->second   // 58
+
+Les autres propriétés accessibles sont:
+
+- timezone
+- timezoneName
+- micro
+- dayOfWeek
+- dayOfMonth
+- dayOfYear
+- daysInMonth
+- timestamp
+- quarter
+
+Aides aux Tests
+---------------
+
+Quand vous écrivez des tests unitaires, il peut être utile de fixer le *time*
+courant. Chronos vous permet de fixer le time courant pour chaque classe.
+Pour l'intégrer dans votre processus de démarrage (bootstrap) de suite de tests,
+vous pouvez inclure ce qui suit::
+
+    Chronos::setTestNow(Chronos::now());
+    MutableDateTime::setTestNow(MutableDateTime::now());
+    Date::setTestNow(Date::now());
+    MutableDate::setTestNow(MutableDate::now());
+
+Ceci va fixer le time courant de tous les objets selon le moment où la suite de
+tests a démarré.
+
+Par exemple, si vous fixez le ``Chronos`` à un moment du passé, chaque nouvelle
+instance de ``Chronos`` créée avec ``now`` ou une chaine de temps relative, sera
+retournée relativement à la date fixée::
+
+    Chronos::setTestNow(new Chronos('1975-12-25 00:00:00'));
+
+    $time = new Chronos(); // 1975-12-25 00:00:00
+    $time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00
+
+Pour réinitialiser la "fixation" du temps, appelez simplement ``setTestNow()``
+sans paramètre ou avec ``null`` comme paramètre.

vendor/cakephp/chronos/docs/ja/conf.py

@@ -0,0 +1,9 @@
+import sys, os
+
+# Append the top level directory of the docs, so we can import from the config dir.
+sys.path.insert(0, os.path.abspath('..'))
+
+# Pull in all the configuration options defined in the global config file..
+from config.all import *
+
+language = 'ja'

vendor/cakephp/chronos/docs/ja/contents.rst

@@ -0,0 +1,7 @@
+.. toctree::
+    :maxdepth: 2
+    :caption: CakePHP Chronos
+
+    /index
+
+    API <https://api.cakephp.org/chronos>

vendor/cakephp/chronos/docs/ja/index.rst

@@ -0,0 +1,304 @@
+Chronos
+#######
+
+Chronos (クロノス) は、 ``DateTime`` オブジェクトへの拡張の依存関係の無いコレクションを提供します。
+便利なメソッドに加えて、Chronos は以下を提供します。
+
+* カレンダー日付のための ``Date`` オブジェクト
+* イミュータブルな日付と日時オブジェクト
+* プラグインのような翻訳システム。ライブラリーは英語のみの翻訳を含んでいます。
+  しかし、全ての言語サポートのために、 ``cakephp/i18n`` を使うことができます。
+
+インストール
+------------
+
+Chronos をインストールするためには、 ``composer`` を利用することができます。
+アプリケーションの ROOT ディレクトリー（composer.json ファイルのある場所）
+で以下のように実行します。 ::
+
+    php composer.phar require cakephp/chronos "@stable"
+
+概要
+----
+
+Chronos は PHP が提供する DateTime オブジェクトのいくつかの拡張を提供します。
+Chronos は ``DateInterval`` の拡張機能および、ミュータブル（変更可能）と
+イミュータブル（変更不可）な 日付/時刻 の派生系をカバーする5つのクラスを提供します。
+
+* ``Cake\Chronos\Chronos`` はイミュータブルな *日付と時刻* オブジェクト。
+* ``Cake\Chronos\Date`` はイミュータブルな *日付* オブジェクト。
+* ``Cake\Chronos\MutableDateTime`` はミュータブルな *日付と時刻* オブジェクト。
+* ``Cake\Chronos\MutableDate`` はミュータブルな *日付* オブジェクト。
+* ``Cake\Chronos\ChronosInterval`` は ``DateInterval`` の拡張機能。
+
+最後に、もしあなたが Chronos が提供する 日付/時刻 のオブジェクトに対して型宣言を行ないたい場合、
+``Cake\Chronos\ChronosInterface`` を使用することができます。
+全ての日付と時間のオブジェクトはこのインターフェイスを実装しています。
+
+インスタンスの作成
+------------------
+
+Chronos または Date のインスタンスを取得するためには、多くの方法があります。
+異なる引数セットで動作する多くのファクトリーメソッドがあります。 ::
+
+    use Cake\Chronos\Chronos;
+
+    $now = Chronos::now();
+    $today = Chronos::today();
+    $yesterday = Chronos::yesterday();
+    $tomorrow = Chronos::tomorrow();
+
+    // 相対式のパース
+    $date = Chronos::parse('+2 days, +3 hours');
+
+    // 日付と時間の整数値
+    $date = Chronos::create(2015, 12, 25, 4, 32, 58);
+
+    // 日付または時間の整数値
+    $date = Chronos::createFromDate(2015, 12, 25);
+    $date = Chronos::createFromTime(11, 45, 10);
+
+    // 整形した値にパース
+    $date = Chronos::createFromFormat('m/d/Y', '06/15/2015');
+
+イミュータブルオブジェクトの動作
+--------------------------------
+
+もしあなたが、PHP の ``DateTime`` オブジェクトを使用したことがあるなら、
+*ミュータブル* オブジェクトは簡単に使用できます。
+Chronos はミュータブルオブジェクトを提供しますが、これは *イミュータブル* オブジェクトにもなります。
+イミュータブルオブジェクトはオブジェクトが変更されるたびにオブジェクトのコピーを作ります。
+なぜなら、日時周りの変更メソッドは必ずしも透明でないため、データが誤って、
+または開発者が知らない内に変更してしまうからです。
+イミュータブルオブジェクトはデータが誤って変更されることを防止し、
+順序ベースの依存関係の問題の無いコードを作ります。
+不変性は、変更時に忘れずに変数を置き換える必要があることを意味しています。 ::
+
+    // このコードはイミュータブルオブジェクトでは動作しません
+    $time->addDay(1);
+    doSomething($time);
+    return $time
+
+    // このコードは期待通りに動作します
+    $time = $time->addDay(1);
+    $time = doSomething($time);
+    return $time
+
+各修正の戻り値をキャプチャーすることによって、コードは期待通りに動作します。
+イミュータブルオブジェクトを持っていて、ミュータブルオブジェクトを作りたい場合、
+``toMutable()`` が使用できます。 ::
+
+    $inplace = $time->toMutable();
+
+日付オブジェクト
+------------------
+
+PHP は単純な DateTime オブジェクトだけを提供します。このクラスのカレンダー日付の表現で、
+タイムゾーンおよび、本当に「日」の概念に属していないタイムコンポーネントを含むと、
+少し厄介な可能性があります。
+Chronos は日時表現のための ``Date`` オブジェクトを提供します。
+これらのオブジェクトの時間とタイムゾーンは常に ``00:00:00 UTC`` に固定されており、
+全ての書式/差分のメソッドは一日単位で動作します。 ::
+
+    use Cake\Chronos\Date;
+
+    $today = Date::today();
+
+    // 時間/タイムゾーンの変更は無視されます
+    $today->modify('+1 hours');
+
+    // 出力 '2015-12-20'
+    echo $today;
+
+変更メソッド
+------------
+
+Chronos オブジェクトは細やかに値を変更できるメソッドを提供します。 ::
+
+    // 日時の値のコンポーネントを設定
+    $halloween = Date::create()
+        ->year(2015)
+        ->month(10)
+        ->day(31)
+        ->hour(20)
+        ->minute(30);
+
+また、日付部分を相対日付に変更することもできます。 ::
+
+    $future = Date::create()
+        ->addYear(1)
+        ->subMonth(2)
+        ->addDays(15)
+        ->addHours(20)
+        ->subMinutes(2);
+
+また、ある時間の中で、定義された時点に飛ぶことも可能です。 ::
+
+    $time = Chronos::create();
+    $time->startOfDay();
+    $time->endOfDay();
+    $time->startOfMonth();
+    $time->endOfMonth();
+    $time->startOfYear();
+    $time->endOfYear();
+    $time->startOfWeek();
+    $time->endOfWeek();
+
+また、1週間中の特定の日にも飛べます。 ::
+
+    $time->next(ChronosInterface::TUESDAY);
+    $time->previous(ChronosInterface::MONDAY);
+
+:abbr:`DST (夏時間)` の遷移の前後で日付/時間を変更すると、
+あなたの操作で時間が増減するかもしれませんが、その結果、意図しない時間の値になります。
+これらの問題を回避するには、最初にタイムゾーンを ``UTC`` に変更し、時間を変更します。 ::
+
+    // 余分な時間が追加されました
+    $time = new Chronos('2014-03-30 00:00:00', 'Europe/London');
+    debug($time->modify('+24 hours')); // 2014-03-31 01:00:00
+
+    // 最初に UTC に切り替え、そして更新
+    $time = $time->setTimezone('UTC')
+        ->modify('+24 hours');
+
+時間を変更すると、元のタイムゾーンを追加してローカライズされた時間を取得することができます。
+
+比較メソッド
+------------
+
+Chronos の日付/時間オブジェクトの2つのインスタンスを様々な方法で比較することができます。 ::
+
+    // 比較のフルセットが存在します
+    // ne, gt, lt, lte.
+    $first->eq($second);
+    $first->gte($second);
+
+    // カレントオブジェクトが2つのオブジェクトの間にあるかどうかを確認します。
+    $now->between($start, $end);
+
+    // どちらの引数が最も近い (closest) か、または最も遠い (farthest) かを見つけます。
+    $now->closest($june, $november);
+    $now->farthest($june, $november);
+
+また、与えられた値のカレンダーに当たる場所について問い合わせできます。 ::
+
+    $now->isToday();
+    $now->isYesterday();
+    $now->isFuture();
+    $now->isPast();
+
+    // 曜日をチェック
+    $now->isWeekend();
+
+    // 他の曜日のメソッドも全て存在します。
+    $now->isMonday();
+
+また、値が相対的な期間内にあったかどうかを見つけることができます。 ::
+
+    $time->wasWithinLast('3 days');
+    $time->isWithinNext('3 hours');
+
+差の生成
+--------
+
+日時比較に加えて、2つの値の差や変化の計算は一般的なタスクです。 ::
+
+    // 差をあらわす DateInterval を取得
+    $first->diff($second);
+
+    // 特定の単位での差を取得
+    $first->diffInHours($second);
+    $first->diffInDays($second);
+    $first->diffInWeeks($second);
+    $first->diffInYears($second);
+
+フィードやタイムラインで使用するのに適した、人が読める形式の差を生成することができます。 ::
+
+    // 現在からの差
+    echo $date->diffForHumans();
+
+    // 別の時点からの差
+    echo $date->diffForHumans($other); // 1時間前;
+
+フォーマットの設定
+------------------
+
+Chronos は、出力した日時オブジェクトを表示するための多くのメソッドを提供します。 ::
+
+    // setToStringFormat() が制御するフォーマットを使用します
+    echo $date;
+
+    // 別の標準フォーマット
+    echo $time->toAtomString();      // 1975-12-25T14:15:16-05:00
+    echo $time->toCookieString();    // Thursday, 25-Dec-1975 14:15:16 EST
+    echo $time->toIso8601String();   // 1975-12-25T14:15:16-05:00
+    echo $time->toRfc822String();    // Thu, 25 Dec 75 14:15:16 -0500
+    echo $time->toRfc850String();    // Thursday, 25-Dec-75 14:15:16 EST
+    echo $time->toRfc1036String();   // Thu, 25 Dec 75 14:15:16 -0500
+    echo $time->toRfc1123String();   // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toRfc2822String();   // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toRfc3339String();   // 1975-12-25T14:15:16-05:00
+    echo $time->toRssString();       // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toW3cString();       // 1975-12-25T14:15:16-05:00
+
+    // クォーター/週数を取得
+    echo $time->toQuarter();         // 4;
+    echo $time->toWeek();            // 52
+
+    // 一般的なフォーマット
+    echo $time->toTimeString();           // 14:15:16
+    echo $time->toDateString();           // 1975-12-25
+    echo $time->toDateTimeString();       // 1975-12-25 14:15:16
+    echo $time->toFormattedDateString();  // Dec 25, 1975
+    echo $time->toDayDateTimeString();    // Thu, Dec 25, 1975 2:15 PM
+
+日付要素の抽出
+--------------
+
+日付オブジェクトのプロパティーに直接アクセスして要素を取得することができます。 ::
+
+    $time = new Chronos('2015-12-31 23:59:58');
+    $time->year;    // 2015
+    $time->month;   // 12
+    $time->day;     // 31
+    $time->hour     // 23
+    $time->minute   // 59
+    $time->second   // 58
+
+以下のプロパティーにもアクセスできます。 :
+
+- timezone
+- timezoneName
+- micro
+- dayOfWeek
+- dayOfMonth
+- dayOfYear
+- daysInMonth
+- timestamp
+- quarter
+
+テストの支援
+------------
+
+単体テストを書いている時、現在時刻を固定すると便利です。Chronos は、
+各クラスの現在時刻を修正することができます。
+テストスイートの bootstrap 処理に以下を含めることができます。 ::
+
+    Chronos::setTestNow(Chronos::now());
+    MutableDateTime::setTestNow(MutableDateTime::now());
+    Date::setTestNow(Date::now());
+    MutableDate::setTestNow(MutableDate::now());
+
+これでテストスイートが開始された時点で全てのオブジェクトの現在時刻を修正します。
+
+例えば、 ``Chronos`` を過去のある瞬間に固定した場合、新たな ``Chronos``
+のインスタンスが生成する ``now`` または相対時刻の文字列は、
+固定された時刻の相対を返却します。 ::
+
+    Chronos::setTestNow(new Chronos('1975-12-25 00:00:00'));
+
+    $time = new Chronos(); // 1975-12-25 00:00:00
+    $time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00
+
+固定をリセットするには、 ``setTestNow()`` をパラメーター無し、または ``null`` を設定して
+再び呼び出してください。

vendor/cakephp/chronos/docs/pt/conf.py

@@ -0,0 +1,9 @@
+import sys, os
+
+# Append the top level directory of the docs, so we can import from the config dir.
+sys.path.insert(0, os.path.abspath('..'))
+
+# Pull in all the configuration options defined in the global config file..
+from config.all import *
+
+language = 'pt'

vendor/cakephp/chronos/docs/pt/contents.rst

@@ -0,0 +1,7 @@
+.. toctree::
+    :maxdepth: 2
+    :caption: CakePHP Chronos
+
+    /index
+
+    API <https://api.cakephp.org/chronos>

vendor/cakephp/chronos/docs/pt/index.rst

@@ -0,0 +1,285 @@
+Chronos
+#######
+
+O Chronos oferece uma coleção independente de extensões para lidar com o objeto
+``DateTime``. Além de métodos de conveniência, o Chronos oferece:
+
+* Objetos ``Date`` para representar datas de calendário.
+* Objetos *date* e *datetime* imutáveis.
+* Um sistema de tradução acoplável. Apenas traduções em inglês estão incluídas
+  na biblioteca. Todavia, ``cakephp/i18n`` pode ser usado para suporte completo
+  a idiomas.
+
+Instalação
+----------
+
+Para instalar o Chronos, você deve usar o ``composer``. A partir do diretório
+*ROOT* de sua aplicação (local onde o arquivo composer.json está localizado)
+execute o seguinte comando::
+
+    php composer.phar require cakephp/chronos "@stable"
+
+Visão geral
+-----------
+
+Chronos oferece extensões para lidar com objetos *DateTime* do PHP. 5 classes
+cobrem variantes de data/hora mutáveis e imutáveis e uma extensão do objeto
+``DateInterval``.
+
+* ``Cake\Chronos\Chronos`` é um objeto *date & time* imutável.
+* ``Cake\Chronos\Date`` é um objeto *date* imutável.
+* ``Cake\Chronos\MutableDateTime`` é um objeto *date and time* mutável.
+* ``Cake\Chronos\MutableDate`` é um objeto *date* mutável.
+* ``Cake\Chronos\ChronosInterval`` é uma extensão do objeto ``DateInterval``.
+
+Por último, se você quiser usar o *typehint* em objetos do Chronos, será preciso
+usar a interface ``Cake\Chronos\ChronosInterface``. Todos os objetos de data e
+hora implementam essa interface.
+
+Criando instâncias
+------------------
+
+Existem várias maneiras de criar instâncias do Chronos ou mesmo, do objeto Date.
+Um número considerável de métodos padrão que funcionam com conjuntos diferentes
+de argumentos::
+
+    use Cake\Chronos\Chronos;
+
+    $now = Chronos::now();
+    $today = Chronos::today();
+    $yesterday = Chronos::yesterday();
+    $tomorrow = Chronos::tomorrow();
+
+    // Interpreta expressões relativas.
+    $date = Chronos::parse('+2 days, +3 hours');
+
+    // Valores inteiros de Date e Time.
+    $date = Chronos::create(2015, 12, 25, 4, 32, 58);
+
+    // Valores inteiros de Date ou Time.
+    $date = Chronos::createFromDate(2015, 12, 25);
+    $date = Chronos::createFromTime(11, 45, 10);
+
+    // Interpreta valores formatados.
+    $date = Chronos::createFromFormat('m/d/Y', '06/15/2015');
+
+Trabalhando com objetos imutáveis
+---------------------------------
+
+Se você é familiarizado com os objetos ``DateTime`` do PHP, você se sentirá
+confortável com objetos *mutáveis*. Além de objetos mutáveis o Chronos também
+oferece objetos imutáveis que por sua vez criam cópias de objetos toda vez que
+um objeto é modificado. Devido ao fato de que metodos modificadores relativos
+a data e hora nem sempre serem transparentes, informações podem ser modificadas
+acidentalmente ou sem que o desenvolvedor saiba. Objetos imutáveis previnem
+essas alterações acidentais nos dados. Imutabilidade significa que você deverá
+lembrar de substituir variáveis usando modificadores::
+
+    // Esse código não funciona com objetos imutáveis
+    $time->addDay(1);
+    doSomething($time);
+    return $time;
+
+    // Esse funciona como o esperado
+    $time = $time->addDay(1);
+    $time = doSomething($time);
+    return $time;
+
+Ao capturar o valor de retorno de cada modificação, seu código funcionará como o
+esperado. Se você tem um objeto imutável e quer criar um mutável a partir do
+mesmo, use ``toMutable()``::
+
+    $inplace = $time->toMutable();
+
+Objetos Date
+------------
+
+O PHP disponibiliza um único objeto DateTime. Representar datas de calendário
+pode ser um pouco desconfortável por essa classe, uma vez que ela inclui
+*timezones* e componentes de hora que realmente não se encaixam no conceito de
+'dia'. O Chronos oferece um objeto ``Date`` para representar datas. A hora e a
+zona desse objeto é sempre fixado em ``00:00:00 UTC`` e todos os métodos de
+formatação/diferença operam sob a resolução de dia::
+
+    use Cake\Chronos\Date;
+
+    $today = Date::today();
+
+    // Mudanças na hora/timezone são ignoradas
+    $today->modify('+1 hours');
+
+    // Exibe '2016-08-15'
+    echo $today;
+
+Métodos modificadores
+---------------------
+
+Objetos Chronos disponibilizam métodos que permitem a modificação de valores de
+forma granular::
+
+    // Define componentes do valor datetime
+    $halloween = Date::create()
+        ->year(2015)
+        ->month(10)
+        ->day(31)
+        ->hour(20)
+        ->minute(30);
+
+Você também pode modificar partes da data relativamente::
+
+    $future = Date::create()
+        ->addYear(1)
+        ->subMonth(2)
+        ->addDays(15)
+        ->addHours(20)
+        ->subMinutes(2);
+
+Também é possível realizar grandes saltos para períodos definidos no tempo::
+
+    $time = Chronos::create();
+    $time->startOfDay();
+    $time->startOfMonth();
+    $time->endOfMonth();
+    $time->endOfYear();
+    $time->startOfWeek();
+    $time->endOfWeek();
+
+Ou ainda para dias específicos da semana::
+
+    $time->next(ChronosInterface::TUESDAY);
+    $time->previous(ChronosInterface::MONDAY);
+
+Métodos de comparação
+---------------------
+
+Uma vez que você possui 2 instâncias de objetos data/hora do Chronos, é possível
+compará-los de várias maneiras::
+
+    // Coleção completa de comparadores
+    // ne, gt, lt, lte.
+    $first->eq($second);
+    $first->gte($second);
+
+    // Veja se o objeto atual está entre outros
+    $now->between($start, $end);
+
+    // Encontre qual argumento está mais perto ou mais longe
+    $now->closest($june, $november);
+    $now->farthest($june, $november);
+
+Você também pode arguir sobre quando um determinado valor cai no calendário::
+
+    $now->isToday();
+    $now->isYesterday();
+    $now->isFuture();
+    $now->isPast();
+
+    // Verifica se o dia é no final de semana
+    $now->isWeekend();
+
+    // Todos os métodos para outros dias da semana existem também
+    $now->isMonday();
+
+Você também pode verificar se um determinado valor está dentro de um período de
+tempo relativo::
+
+    $time->wasWithinLast('3 days');
+    $time->isWithinNext('3 hours');
+
+Gerando diferenças
+------------------
+
+Em adição à comparação de *datetimes*, calcular diferenças ou deltas entre
+valores é uma tarefa simples::
+
+    // Recebe um DateInterval representando a diferença
+    $first->diff($second);
+
+    // Recebe a diferença como um contador de unidades específicas
+    $first->diffInHours($second);
+    $first->diffInDays($second);
+    $first->diffInWeeks($second);
+    $first->diffInYears($second);
+
+Você pode gerar diferenças de fácil leitura para humanos para usar em um *feed*
+ou *timeline*::
+
+    // Diferença em relação ao momento atual
+    echo $date->diffForHumans();
+
+    // Diferença em relação a outro período no tempo
+    echo $date->diffForHumans($other); // 1 hora atrás;
+
+Formatando strings
+------------------
+
+O Chronos disponibiliza métodos para exibir nossos objetos *datetime*::
+
+    // Usa o formato controlado por setToStringFormat()
+    echo $date;
+
+    // Diferentes padrões de formato
+    echo $time->toAtomString();      // 1975-12-25T14:15:16-05:00
+    echo $time->toCookieString();    // Thursday, 25-Dec-1975 14:15:16 EST
+    echo $time->toIso8601String();   // 1975-12-25T14:15:16-05:00
+    echo $time->toRfc822String();    // Thu, 25 Dec 75 14:15:16 -0500
+    echo $time->toRfc850String();    // Thursday, 25-Dec-75 14:15:16 EST
+    echo $time->toRfc1036String();   // Thu, 25 Dec 75 14:15:16 -0500
+    echo $time->toRfc1123String();   // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toRfc2822String();   // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toRfc3339String();   // 1975-12-25T14:15:16-05:00
+    echo $time->toRssString();       // Thu, 25 Dec 1975 14:15:16 -0500
+    echo $time->toW3cString();       // 1975-12-25T14:15:16-05:00
+
+    // Recebe o trimestre
+    echo $time->toQuarter();         // 4;
+
+Extraindo componentes de data
+-----------------------------
+
+Podemos receber partes de um objeto *date* acessando propriedades::
+
+    $time = new Chronos('2015-12-31 23:59:58');
+    $time->year;    // 2015
+    $time->month;   // 12
+    $time->day;     // 31
+    $time->hour     // 23
+    $time->minute   // 59
+    $time->second   // 58
+
+Outras propriedades que podem ser acessadas são:
+
+- timezone
+- timezoneName
+- micro
+- dayOfWeek
+- dayOfMonth
+- dayOfYear
+- daysInMonth
+- timestamp
+- quarter
+
+Auxílio para testes
+-------------------
+
+Ao escrever testes unitários, fixar a hora atual é bastante útil. O Chronos
+lhe permite fixar a hora atual para cada classe. Como parte das suas ferramentas
+de testes, você pode incluir o seguinte::
+
+    Chronos::setTestNow(Chronos::now());
+    MutableDateTime::setTestNow(MutableDateTime::now());
+    Date::setTestNow(Date::now());
+    MutableDate::setTestNow(MutableDate::now());
+
+Isso irá corrigir a hora atual de todos os objetos para o momento em que o
+processo de testes foi iniciado.
+
+Por exemplo, se você fixar o ``Chronos`` em algum momento no passado, qualquer
+nova instância do ``Chronos`` criada com ``now`` ou uma *string* de tempo
+relativa, teremos um retorno referente ao tempo fixado::
+
+    Chronos::setTestNow(new Chronos('1975-12-25 00:00:00'));
+
+    $time = new Chronos(); // 1975-12-25 00:00:00
+    $time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00
+