66 lines
1.9 KiB
PHP
66 lines
1.9 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of the Symfony package.
|
|
*
|
|
* (c) Fabien Potencier <fabien@symfony.com>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Symfony\Polyfill\Intl\Icu\DateFormat;
|
|
|
|
/**
|
|
* Parser and formatter for date formats.
|
|
*
|
|
* @author Igor Wiedler <igor@wiedler.ch>
|
|
*
|
|
* @internal
|
|
*/
|
|
abstract class Transformer
|
|
{
|
|
/**
|
|
* Format a value using a configured DateTime as date/time source.
|
|
*
|
|
* @param \DateTime $dateTime A DateTime object to be used to generate the formatted value
|
|
* @param int $length The formatted value string length
|
|
*
|
|
* @return string The formatted value
|
|
*/
|
|
abstract public function format(\DateTime $dateTime, int $length): string;
|
|
|
|
/**
|
|
* Returns a reverse matching regular expression of a string generated by format().
|
|
*
|
|
* @param int $length The length of the value to be reverse matched
|
|
*
|
|
* @return string The reverse matching regular expression
|
|
*/
|
|
abstract public function getReverseMatchingRegExp(int $length): string;
|
|
|
|
/**
|
|
* Extract date options from a matched value returned by the processing of the reverse matching
|
|
* regular expression.
|
|
*
|
|
* @param string $matched The matched value
|
|
* @param int $length The length of the Transformer pattern string
|
|
*
|
|
* @return array An associative array
|
|
*/
|
|
abstract public function extractDateOptions(string $matched, int $length): array;
|
|
|
|
/**
|
|
* Pad a string with zeros to the left.
|
|
*
|
|
* @param string $value The string to be padded
|
|
* @param int $length The length to pad
|
|
*
|
|
* @return string The padded string
|
|
*/
|
|
protected function padLeft(string $value, int $length): string
|
|
{
|
|
return str_pad($value, $length, '0', \STR_PAD_LEFT);
|
|
}
|
|
}
|