A classe SAPO.Utility.Date é um grande utilitário para trabalhar com datas em JavaScript.
Para usar esta classe basta incluir:
<!-- --> <script type="text/javascript" src="https://js.sapo.pt/SAPO/"></script> <script type="text/javascript" src="https://js.sapo.pt/SAPO/Utility/Date/0.1/"></script>
Inspirando-nos na função "date()" do PHP criámos o método get() com quase todas as funcionalidades, mas em JavaScript.
SAPO.Utility.Date.get();
Este método recebe dois parâmetros, sendo o segundo opcional.
O primeiro parâmetro é o formato da data, como na função "date()" do PHP.
O segundo é objecto Date com a data pretendida. Quando este parâmetro não é passado, é usada a data actual.
Exemplos para a data:
28 de Janeiro de 2010 às 13:03:51
<!-- --> SAPO.Utility.Date.get("Y-m-d H:i:s"); /* 2010-01-28 13:03:51 */ SAPO.Utility.Date.get("U"); /* 1264683831 */ SAPO.Utility.Date.get("r"); /* Thu, 28 Jan 2010 13:03:51 +0000 */
Passando o segundo parâmetro, podemos definir a data e formatar essa data como nos pretendermos.
<!-- --> SAPO.Utility.Date.get('Y-m-d H:i:s', new Date(1234567890000)); /* 2009-02-13 23:31:30 */ SAPO.Utility.Date.get('Y-m-d H:i:s', new Date("October 13, 1975 11:13:00")); /* 1975-10-13 11:13:00 */
Para ver o sample basta ir a:
Este post pretende dar uma pequena introdução ao uso da LibSAPO.js e aos seus componentes mais básicos.
A LibSAPO.js tem como dependência principal o objecto SAPO.
Deste objecto dependem todas as outras classes utilitárias e widgets do SAPO. Assim, para a utilização de qualquer outra classe, será necessário incluir o ficheiro https://js.sapo.pt/SAPO/
Este é um ficheiro muito pequeno que apenas trata da inicialização da lib e inclui alguns utilitários básicos necessários para o uso da lib.
O objecto SAPO e o método s$, que é um alias para o método document.getElementById são as únicas variáveis globais declaradas pela LibSAPO.js. Mesmo assim, apesar não "poluirmos" o DOM, disponibilizamos mais dois métodos, como extensão do objecto Function:
bindObj() e bindObjEvent()
Para quem está familiarizado com o Prototype, estes métodos são semelhates ao bind() e ao bindAsEventListener().
Sem a adição de quaisquer módulos, o objecto SAPO fornece os seguintes métodos:
SAPO.namespace() - cria o namespace no objecto "SAPO"
SAPO.Browser - Objecto que nos dá a informação do browser. Deve apenas ser usado em casos muito específicos, pois não é boa prática detectar funcionalidades pela designação do browser, mas sim pela detecção da funcionalidade.
As propriedades que podemos encontrar são:
. LibSAPO.js - Documentação...
. SAPO