Depende do que você precisa.
O número gigante, representando por um long
, é um timestamp. Ele representa um único instante, um ponto na linha do tempo, que corresponde à quantidade de milissegundos desde o Unix Epoch (cujo valor é 01/01/1970, à meia-noite em UTC).
O número 1335205592410
, por exemplo, representa o instante ocorrido 1335205592410ms depois do Unix Epoch. O detalhe é que esse mesmo valor corresponde a uma data e hora diferente, dependendo do timezone (fuso-horário). Alguns exemplos:
- 23 de abril de 2012 às 15:26:32.410 em São Paulo
- 24 de abril de 2012 às 03:26:32.410 em Tóquio
- 23 de abril de 2012 às 18:26:32.410 em UTC
Ou seja, o mesmo valor de timestamp (1335205592410
) corresponde a todas as datas e horas acima. Em São Paulo, esse timestamp corresponde ao dia 23 às 15h, e em Tóquio, ao dia 24 às 3 da manhã. Mas o instante é o mesmo, por isso o valor do timestamp é o mesmo para ambos.
Dito isso, o timestamp é útil para quando você precisar saber o instante exato em que algo aconteceu, independente de fusos-horários. Caso você precise "traduzir" o timestamp para uma data e hora, basta usar as APIs do Java para esta transformação.
Java >= 8
A partir do Java 8 você pode usar a API java.time
, muito mais moderna e que corrige os vários problemas da API anterior (Date
e Calendar
).
Para converter o timestamp para uma data e hora, primeiro usamos um java.time.Instant
, que representa um instante específico (um ponto na linha do tempo), ou seja, exatamente o mesmo conceito de um timestamp.
Em seguida, convertemos este Instant
para um java.time.ZonedDateTime
, que representa uma data e hora em um timezone específico. Lembre-se que o mesmo timestamp corresponde a uma data e hora diferentes em cada timezone, então temos que escolher um e passar para a classe java.time.ZoneId
:
Instant instant = Instant.ofEpochMilli(1335205592410L);
// converte para o timezone America/Sao_Paulo
ZonedDateTime dataHoraSp = instant.atZone(ZoneId.of("America/Sao_Paulo"));
System.out.println(dataHoraSp);
A saída é:
2012-04-23T15:26:32.410-03:00[America/Sao_Paulo]
O timezone escolhido foi America/Sao_Paulo
, que está no formato da IANA (sempre com este formato Continente/Região
). Você pode verificar todos os timezones disponíveis usando o método ZoneId.getAvailableZoneIds()
. E se quiser usar o timezone default que estiver configurado na JVM, basta usar ZoneId.systemDefault()
em vez de ZoneId.of(...)
.
A grande vantagem de usar os timezones da IANA é que eles possuem todo o histórico de alterações no horário local de cada região. Por isso, ajustes como horário de verão são feitos automaticamente, e o ZonedDateTime
terá os valores corretos de data e hora.
Para mais detalhes sobre esta API, sugiro o tutorial da Oracle e esta pergunta. Um detalhe é que, caso o banco que você está usando tenha um driver compatível com o JDBC 4.2, é possível trabalhar diretamente com o Instant
, usando os métodos setObject
da classe java.sql.PreparedStatement
e getObject
da classe java.sql.ResultSet
:
PreparedStatement ps = ...
// seta o java.time.Instant
ps.setObject(1, datetime.toInstant());
// obter o Instant do banco
ResultSet rs = ...
Instant instant = rs.getObject(1, Instant.class);
// converter o instant para o timezone
ZonedDateTime zdt = instant.atZone(ZoneId.of("America/Sao_Paulo"));
Java <= 7
No Java <= 7, basta converter o timestamp para java.util.Date
. Mas como esta classe não possui informação sobre o timezone, o melhor jeito de obter a data e hora em um formato específico é usando um java.text.SimpleDateFormat
e setando um java.util.TimeZone
nele:
// cria Date a partir do timestamp
Date date = new Date(1335205592410L);
// gerar String que corresponde à data e hora em um timezone
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSXXX");
sdf.setTimeZone(TimeZone.getTimeZone("America/Sao_Paulo"));
System.out.println(sdf.format(date)); // 2012-04-23T15:26:32.410-03:00
O resultado será uma String
com a data e hora correspondentes ao timestamp, no timezone especificado no SimpleDateFormat
:
2012-04-23T15:26:32.410-03:00
Outra opção é criar um java.util.Calendar
, caso deseje obter os campos de data e hora individualmente, por exemplo:
// ou crie um Calendar, se quiser obter os campos de data e hora individualmente
Calendar calendar = Calendar.getInstance(TimeZone.getTimeZone("America/Sao_Paulo"));
calendar.setTimeInMillis(1335205592410L); // usar o valor do timestamp
System.out.println(calendar.get(Calendar.HOUR_OF_DAY)); // 15
System.out.println(calendar.get(Calendar.DAY_OF_MONTH)); // 23
Outra alternativa é usar o ThreeTen Backport, um excelente backport do java.time
, que funciona no JDK 6 e 7. As classes possuem os mesmos nomes e funcionalidades do java.time
, a diferença é que o nome do pacote é org.threeten.bp
.
Sempre devo usar o timestamp?
Depende. Que tipo de informação você vai guardar?
Se quiser saber exatamente em que instante algo ocorreu, independente do fuso horário, o timestamp é a melhor opção.
Mas e se você só quer gravar a data de nascimento para um cadastro simples? Ou seja, só precisa do dia, mês e ano (e não precisa das horas, nem do fuso-horário). Neste caso o timestamp é um exagero (pois possui mais informação do que você precisa), e além disso pode causar erros inesperados.
Lembre-se - novamente - que o mesmo valor de timestamp pode resultar em uma data e hora diferente, dependendo do timezone escolhido. Se você simplesmente criar um java.util.Date
, por exemplo, e imprimir, poderá ter um resultado diferente a cada execução:
TimeZone.setDefault(TimeZone.getTimeZone("America/Sao_Paulo"));
// cria Date a partir do timestamp
Date date = new Date(1335205592410L);
System.out.println(date.getTime() + "=" + date);
// mudar o timezone default
TimeZone.setDefault(TimeZone.getTimeZone("Asia/Tokyo"));
System.out.println(date.getTime() + "=" + date);
Repare que imprimi o valor de date.getTime()
(que retorna o valor do timestamp), e em seguida o próprio date
, que internamente chamará o seu método toString()
. A saída é:
1335205592410=Mon Apr 23 15:26:32 BRT 2012
1335205592410=Tue Apr 24 03:26:32 JST 2012
Repare que, apesar do timestamp não ter mudado, a data e hora mudaram. Isso acontece porque Date
, ao ser impresso, usa o timezone default da JVM para converter o timestamp para uma data e hora. E quando eu mudei o timezone default usando TimeZone.setDefault
, o retorno de toString()
também muda. O valor do timestamp não muda, mas o valor da data e hora que é impresso sim. E isso vale também para SimpleDateFormat
, que quando criado, usa o timezone default que estiver setado no momento, então todas as datas sendo formatadas (e todas as strings sendo parseadas) serão afetadas também (isso pode ser evitado se você setar o timezone, usando setTimeZone
no SimpleDateFormat
, como já explicado anteriormente).
O problema é que qualquer aplicação pode chamar TimeZone.setDefault
e afetar todas as outras aplicações que estão rodando na mesma JVM. E de repente você começa a ver valores de Date
inesperados, embora o seu valor (o timestamp) não tenha mudado.
Infelizmente, antes do Java 8 não havia (usando somente a API nativa) uma forma confiável de guardar apenas uma data (somente dia, mês e ano, sem horas nem timezone). Mesmo a classe java.sql.Date
, que foi feita para representar este conceito, internamente possui um timestamp e sofre do mesmo problema (seu valor ao ser impressa muda conforme o timezone default da JVM).
No Java >= 8 é possível usar a classe java.time.LocalDate
, que representa somente um dia, mês e ano, sem qualquer noção de horários ou timezones. Neste caso, não há qualquer relação com timestamps, pois tendo somente a data, sem saber o horário e o timezone, não há como ter o timestamp correspondente.
A vantagem é que os valores impressos são sempre os mesmos, não importando qual o timezone default:
TimeZone.setDefault(TimeZone.getTimeZone("America/Sao_Paulo"));
// 23 de abril de 2012
LocalDate dt = LocalDate.of(2012, 4, 23);
System.out.println(dt);
// mudar o timezone default
TimeZone.setDefault(TimeZone.getTimeZone("Asia/Tokyo"));
System.out.println(dt);
Como LocalDate
não sofre interferência do timezone, a saída é:
2012-04-23
2012-04-23
E da mesma forma que Instant
, um LocalDate
também pode ser utilizado diretamente, caso o banco de dados já tenha um driver compatível com JDBC 4.2. Consulte a respectiva documentação do seu banco de dados para saber se é possível usar estas classes.
Sobre os formatos indicados
Primeiro sobre esses dois:
/Date(1335205592410)/
/Date(1335205592410-0500)/
Esse é, na minha opinião, um dos piores e mais confusos formatos já criados. Ambos possuem o valor do timestamp, e o segundo ainda tem um offset, que é a diferença com relação a UTC (-0500
, que significa "5 horas antes de UTC"). Provavelmente deve servir para converter o timestamp para uma data e hora no referido offset.
Apenas como curiosidade, é possível fazer o parsing com o java.time
:
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeFormatterBuilder;
import java.time.temporal.ChronoField;
import java.time.OffsetDateTime;
DateTimeFormatter parser = new DateTimeFormatterBuilder()
// parte inicial
.appendLiteral("/Date(")
// para o timestamp, usa-se o InstantSeconds e os milissegundos
.appendValue(ChronoField.INSTANT_SECONDS)
.appendValue(ChronoField.MILLI_OF_SECOND, 3)
// offset opcional (colchetes indicam que o campo é opcional)
.appendPattern("[XX]")
// se não tiver offset, assume-se que é zero (UTC)
.parseDefaulting(ChronoField.OFFSET_SECONDS, 0)
// parte final, e cria o DateTimeFormatter
.appendLiteral(")/").toFormatter();
OffsetDateTime odt1 = OffsetDateTime.parse("/Date(1335205592410)/", parser);
System.out.println(odt1); // 2012-04-23T18:26:32.410Z
OffsetDateTime odt2 = OffsetDateTime.parse("/Date(1335205592410-0500)/", parser);
System.out.println(odt2); // 2012-04-23T13:26:32.410-05:00
Escolhi java.time.OffsetDateTime
, pois representa uma data e hora em um offset específico (que no primeiro caso é zero, o que é o mesmo que dizer que a data/hora está em UTC, e no segundo caso é -0500
, ou "5 horas antes de UTC"). Mas ambas as datas obtidas correspondem ao mesmo instante (ao mesmo timestamp).
Já esses outros formatos:
2012-04-23T18:25:43.511Z
2012-04-21T18:25:43-05:00
Ambos estão no formato ISO 8601. A primeira está em UTC (é o que o "Z" no final significa), e a segunda está no offset -05:00
(5 horas antes de UTC). Repare que o offset pode ser escrito com ou sem dois pontos (-05:00
ou -0500
), ou ainda ter somente o valor das horas (-05
). Mas eu recomendo escrever sempre os minutos também, já que há países que usam fusos horários de meia hora, e até mesmo de 45 minutos.
Outra vantagem do java.time
é que ela já suporta o formato ISO 8601 por padrão:
OffsetDateTime d1 = OffsetDateTime.parse("2012-04-23T18:25:43.511Z");
System.out.println(d1);
OffsetDateTime d2 = OffsetDateTime.parse("2012-04-21T18:25:43-05:00");
System.out.println(d2);
Este código imprime:
2012-04-23T18:25:43.511Z
2012-04-21T18:25:43-05:00
A vantagem do ISO 8601 é ser mais inteligível para humanos (já que ao usar timestamp, não é tão óbvio saber a qual data e hora ele se refere), além de podermos ter valores "parciais", como 2012-04-23
(apenas a data, sem as horas e o offset), 18:25
(somente as horas), etc.
A diferença é que esses valores "parciais" não podem ser traduzidos para um timestamp. Por exemplo, se eu tiver apenas a data "23 de abril de 2012". Sem um horário e um timezone, não tem como saber o instante exato que esta data representa, e por isso não dá para obter um único valor de timestamp (algumas APIs até fazem esta conversão, mas elas implicitamente escolhem algum valor arbitrário para o horário e timezone, e algumas nem permitem que você configure isso). Mas se você só quer fazer o cadastro da data de nascimento dos seus usuários, sem se preocupar com as horas e o fuso horário, então ter apenas o dia, mês e ano é o suficiente.
Se precisar transmitir datas e horas como strings (apenas estes valores, sem se importar com o timezone), o formato ISO 8601 é uma excelente opção.
Só não confunda strings com datas. Uma data/hora representa um conceito: a ideia de um ponto do calendário, um instante na linha do tempo, de um momento específico do dia. Uma string é apenas uma maneira de representar este conceito na forma de texto. Por exemplo, a data "1 de março de 2000" representa este ponto específico do calendário, mas ela pode ser escrita de várias maneiras:
- 01/03/2000
- March 3th, 2000
- 2000-03-01
- etc...
Essas strings são diferentes, mas todas representam a mesma data. "Traduzindo" para o Java, é como se eu tivesse:
String s1 = "01/03/2000";
String s2 = "March 3th, 2000";
String s3 = "2000-03-01";
LocalDate data = LocalDate.of(2000, 3, 1);
Cada String
tem um valor diferente, mas todas representam a mesma data (o mesmo valor que corresponde ao LocalDate
). Ou seja, os mesmos valores numéricos do dia, mês e ano, que estão contidos na classe LocalDate
. Uma data só tem os valores, e quando precisamos vê-los (imprimindo na tela, por exemplo) ou enviá-los (seja em um arquivo, seja na resposta de um serviço em JSON), é preciso transformá-los para uma string em algum formato.
Enfim, usar o timestamp (o valor do long
) não é certo nem errado, tudo depende do que você precisa.