Apenas para atualizar as respostas (que não estão erradas), a partir do Java 8 você pode usar a API java.time
para manipular datas.
Esta API funciona de maneira similar, mas há algumas diferenças importantes com relação a Date
e SimpleDateFormat
. A principal é que há menos comportamentos implícitos (muitos comuns com SimpleDateFormat
) e por isso a primeira impressão é que ela é mais "complicada", por exigir um entendimento maior de como funcionam as datas.
Por exemplo, a abreviação do timezone ("BRT", que corresponde a "Brasília Time" - o famoso Horário de Brasília) é uma informação ambígua. Por isso as abreviações não são consideradas timezones de fato, justamente por não serem padronizadas e haver muita ambiguidade. Entre os exemplos, temos "IST", que é usada na Índia, Irlanda e Israel, ou "CST", que é usada na China, Cuba e Estados Unidos.
Por terem muitas abreviações ambíguas, nem sempre é possível obter um único timezone correspondente. O único jeito de não ter um timezone ambíguo é usar a nomenclatura da IANA. A abreviação BRT, por exemplo, corresponde ao timezone America/Sao_Paulo
(a IANA usa o nome do continente e da cidade mais populosa da região para nomear os timezones), mas também corresponde a America/Recife
, que durante parte do ano é igual a America/Sao_Paulo
, mas é diferente durante o horário de verão - aliás, durante o horário de verão a abreviação muda para BRST (Brasília Summer Time), mas só nos estados que seguem as mesmas regras de America/Sao_Paulo
. Nos que seguem America/Recife
continua sendo BRT, pois estes não tem horário de verão (segundo as regras atuais).
Por apresentarem estas diferenças durante o ano, a IANA considera que America/Sao_Paulo
e America/Recife
são dois timezones diferentes. O fato de eles terem o mesmo horário - e a mesma abreviação - durante parte do ano é apenas um detalhe.
Enfim, eu só disse tudo isso porque SimpleDateFormat
simplesmente assume algum timezone quando é passada uma abreviação (e em casos de ambiguidade não há como controlar qual será usado). Já na nova API temos que especificar qual timezone queremos usar.
Outra diferença é que há vários tipos diferentes para representar datas: um somente com o dia, mês e ano, outro só com o horário, outro com data, hora e timezone, etc. Por isso deve-se escolher o tipo adequado de acordo com os dados que você está trabalhando.
No caso, a string de entrada possui data, hora e timezone, então o tipo indicado é java.time.ZonedDateTime
. Para transformar a string em uma data, usa-se um java.time.format.DateTimeFormatter
. E para configurar o timezone a ser usado (pois a abreviação é ambígua e devemos setar um timezone), usa-se um java.time.format.DateTimeFormatterBuilder
.
Para setar o timezone, usa-se um java.time.ZoneId
com o nome do timezone no formato da IANA. É possível passar vários timezones, por isso estes são colocados em um java.util.Set
:
// timezone a ser usado para a abreviação
Set<ZoneId> zones = new HashSet<>();
zones.add(ZoneId.of("America/Sao_Paulo"));
// criar o DateTimeFormatter
DateTimeFormatter fmt = new DateTimeFormatterBuilder()
// data e hora
.appendPattern("EEE MMM dd HH:mm:ss ")
// abreviação do timezone (usar java.time.format.TextStyle)
.appendZoneText(TextStyle.SHORT, zones)
// ano
.appendPattern(" uuuu")
// usar locale inglês para o dia da semana e mês
.toFormatter(Locale.ENGLISH);
// transformar a string em data
ZonedDateTime datetime = ZonedDateTime.parse("Sun Oct 05 20:59:57 BRT 2014", fmt);
Repare que usei o java.util.Locale
correspondente ao idioma inglês, pois o dia da semana e o mês estão em inglês. Se você não especificar um locale, será usado a configuração default da JVM, e nem sempre pode ser o idioma que você precisa. É melhor setar o locale se você já sabe qual o idioma usado.
Para entender melhor o que são as letras EEE MMM ...
, veja a documentação. Muita atenção porque nem tudo é igual a SimpleDateFormat
. Algumas letras funcionam da mesma maneira, outras de maneira parecida, outras de maneira completamente diferente, etc.
Para salvar no banco, você pode converter para um java.sql.Timestamp
, por exemplo. No Java 8 foram adicionados métodos de conversão para facilitar. O método from
recebe um java.time.Instant
, que pode ser obtido a partir do ZonedDateTime
usando o método toInstant()
:
// converter para java.sql.Timestamp
Timestamp ts = Timestamp.from(datetime.toInstant());
E para converter de volta para ZonedDateTime
, usamos o método toInstant()
, que retorna um Instant
, e em seguida o método atZone
, que converte o Instant
para o timezone indicado:
// converter Timestamp para ZonedDateTime
ZonedDateTime zdt = ts.toInstant().atZone(ZoneId.of("America/Sao_Paulo"));
E é possível obter a string original usando o mesmo DateTimeFormatter
para formatar a data:
String dateStr = zdt.format(fmt);
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"));