Sempre tive a idéia de que trabalhar com datas no Javascript era algo chato, que exigia muitas linhas de código para se conseguir algo simples. Bem, isso hoje certamente não é mais verdade, com a quantidade de scripts e frameworks e todo tipo de interfaces para facilitar a vida do programador, mas resolvi fazer um script que me permitisse manipular strings de data tão facilmente como no PHP. Naturalmente, nem todas as opções de date() estão disponíveis aqui, mas acredito que facilitou muito o trabalho de colher e formatar informações separadas para formar um frase simples como ‘Segunda, 3 de maio de 2006′.

Criei então alguns novos métodos adicionados ao objeto Date.prototype. O principal deles é o Date.toFormattedString(), que devolve a string enviada, com alguns caracteres especiais convertidos para valores de data e hora (veja a tabela de substituição), como na função date() do PHP.
O resultado pode ser em inglês ou português, mas pode-se também definir outros idiomas dinamicamente. Além do Date.toFormattedString(), há algumas outras funcionalidades. Segue o script e algumas explicações.

Há métodos para:

• Formatar data de acordo com uma string de formatação
• Trabalhar com nomes de dias e meses em qualquer idioma
• Converter datas para o formato aceito em arquivos RSS (RFC 2822)
• Converter datas para o formato aceito em arquivos ATOM (RFC 3339)
• Determinar o fuso horário em horas, minutos ou segundos
• Manter os valores do objeto sempre atualizados
• Acionar uma função de relógio a intervalos regulares
• Métodos extras
  • Array.walk -> aplica determinada função a todos os elementos do array
  • String.UCFirst -> transforma a primeira letra da string para caixa alta

Pegue o arquivo aqui date.prototype.js

Exemplo de uso:

Podemos definir o idioma de saída da função toFormattedString().
Para isso há os métodos addLang() e setLang(), que devem ser chamados antes de toFormattedString().
Apenas os idiomas inglês (’en’) e português (’pt-br’) estão disponíveis no sistema e o padrão é inglês.
Para usar português, basta chamar setLang(), passando o parâmetro ‘pt-br’.

Segue uma pequena referência das funções:

Adiciona nomes de dias e meses em um idioma ao sistema. Equivale a definir as propriedades Date.days[’id_do_idioma’] (array com os nomes dos dias) e Date.months[’id_do_idioma’] (array com os nomes dos meses) com os nomes enviados. Veja o exemplo 1.

Define o idioma de trabalho para id enviado. O id precisa fazer referência a um idioma existente (’en’ ou ‘pt-br’) ou que tenha sido adicionado previamente com Date.addLang(). Equivale a definir a propriedade Date.lang para o id enviado. Veja o exemplo 1.

Para adicionar e selecionar um idioma, use addLang() e depois setLang(), assim:

Para retornar valores formatados segundo especificações oficiais, há os métodos toRFC2822 e toRFC3339.

Essa função formata a data definida ao instanciar o objeto Date() de acordo com as especificações no RFC 2822.
>> Tipo de data suportado em formatos RSS.

Essa função formata a data definida ao instanciar o objeto Date() de acordo com as especificações no RFC 3339.
>> Tipo de data suportado em formatos ATOM.

Quando instanciamos um objeto Date, a hora de trabalho é relativa ao momento em que este foi instanciado.
Para construir um relógio, por exemplo, com precisão de segundos, normalmente se executa uma função que instancia o objeto novamente a cada segundo, para obter a hora atualizada. A função descrita a seguir executa esse processo, sem precisar instanciar o objeto novamente.

Mantém o momento para o qual o objeto Date aponta sempre atualizado, de acordo com o parâmetro interval ou a cada 1 segundo, se ele for omitido.. Se seu relógio não precisa de segundos (ou se não se trata de um relógio), seria aconselhável definir interval com um intervalo maior (1 minuto, por exemplo). Opcionalmente, executa a string de código code a cada atualização. Isso torna possível usar o método como uma espécie de setInterval, onde code é executado a cada interval milisegundos. Você pode querer apenas ter o objeto atualizado, para quando o usuário executar determinada ação, a hora estar certa. Para isso basta executar o método enviando o parâmetro interval ou nenhum.

Métodos extra

Tabela de substituição