betterCode() PHP 2025

    DateInterval::format

    (PHP 5 >= 5.3.0, PHP 7, PHP 8)

    DateInterval::format — Formata um intervalo

    Descrição

    public DateInterval::format(string $format): string

    Formata um intervalo.

    Parâmetros

    format

    Os caracteres a seguir são reconhecidos como string no parâmetro format. Cada um dos caracteres de formato deve ser precedidos com o sinal de porcentagem (%).
    Caractere de format Descrição Exemplo de valores
    % % literal %
    Y Anos, em representação numérica, com dois dígitos e zero à esquerda 01, 03
    y Anos, em representação numérica 1, 3
    M Meses, em representação numérica, com dois dígitos e zero à esquerda 01, 03, 12
    m Meses, em representação numérica 1, 3, 12
    D Dias, em representação numérica, com dois dígitos e zero à esquerda 01, 03, 31
    d Dias, em representação numérica 1, 3, 31
    a Número total de dias resultante de DateTime::diff() ou (unknown), caso contrário 4, 18, 8123
    H Horas, em representação numérica, com dois dígitos e zero à esquerda 01, 03, 23
    h Horas, em representação numérica 1, 3, 23
    I Minutos, em representação numérica, com dois dígitos e zero à esquerda 01, 03, 59
    i Minutos, em representação numérica 1, 3, 59
    S Segundos, em representação numérica, com dois dígitos e zero à esquerda 01, 03, 57
    s Segundos, em representação numérica 1, 3, 57
    F Microssegundos, numérico, pelo menos 6 dígitos precedidos com 0 007701, 052738, 428291
    f Microssegundos, numérico 7701, 52738, 428291
    R Sinal "-" quando negativo, "+" quando positivo -, +
    r Sinal "-" quando negativo, sem sinal quando positivo -,

    Valor Retornado

    Retorna o intervalo formatado.

    Registro de Alterações

    Versão Descrição
    7.2.12 Os formatos F e f agora são sempre positivos.
    7.1.0 Os formatos F e f foram adicionados.

    Exemplos

    Exemplo #1 Exemplo da classe DateInterval

    <?php
    $interval     = new DateInterval('P2Y4DT6H8M');
    echo     $interval->format('%d days');

    O exemplo acima produzirá:

    4 days

    Exemplo #2 A classe DateInterval e os pontos de transferência

    <?php
    $interval     = new DateInterval('P32D');
    echo     $interval->format('%d days');

    O exemplo acima produzirá:

    32 days

    Exemplo #3 DateInterval e DateTime::diff() com os modificadores %a e %d

    <?php
    $janeiro     = new DateTime('2010-01-01');
    $fevereiro = new DateTime('2010-02-01');
    $intervalo = $fevereiro->diff($janeiro);

    // %a irá resultar no número total de dias.
    echo $intervalo->format('%a dias totais')."\n";

    // Enquanto %d irá apenas resultar no número de dias ainda não cobertos pelo
    // mês.
    echo $intervalo->format('%m mês, %d dias');

    O exemplo acima produzirá:

    31 total days
1 month, 0 days

    Notas

    Nota:

    O método DateInterval::format() não recalcula pontos de transferência em strings de data/horário. Isto é esperado porque não é possível extrapolar valores como "32 days", o que poderia ser interpretado como qualquer coisa entre "1 month and 4 days" e "1 month and 1 day".

    Veja Também

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicionar nota

    Notas de Usuários 1 note

    up
    2
    online dot cloudmeetings dot marco at gmail dot com
    1 year ago
    Pls note these important abbreviations;

    P: period
    Y: years
    M: months
    D: days
    T: time
    H: hours
    M: minutes
    S: seconds

    The above is from the ISO 8601 - an international standard that defines how to use, store, and transfer date, time, and duration information.
    ＋adicionar nota
    To Top