HOWTO · Java
Converter String para Timestamp em Java
Mostra quatro métodos para converter uma string para carimbo da hora em Java
Nesta página
java.sql.Timestamp representa uma data e hora com precisão de frações de segundo e é usado com frequência em JDBC. Escolha o parser conforme o formato da entrada: use Timestamp.valueOf() para uma data e hora no formato SQL, DateTimeFormatter para um formato personalizado ou LocalDate quando a entrada contiver apenas uma data. Essas conversões não determinam um fuso horário que não esteja presente na entrada.
Use Timestamp.valueOf() para uma string padrão de data e hora
Para uma string como 2024-06-15 14:30:00, Timestamp.valueOf(String) interpreta diretamente o formato de timestamp SQL. A API aceita um valor no formato de escape de timestamp do JDBC, inclusive com frações de segundo opcionais; portanto, não se limita ao formato mostrado aqui, que contém apenas segundos. Use outro parser se a entrada tiver uma ordem diferente ou outros separadores.
Execute este exemplo:
import java.sql.Timestamp;
public class StringToTimestamp {
public static void main(String[] args) {
String input = "2024-06-15 14:30:00";
Timestamp timestamp = Timestamp.valueOf(input);
System.out.println(timestamp);
}
}
2024-06-15 14:30:00.0
O .0 exibido corresponde à parte fracionária dos segundos. A API rejeita valores malformados; valide as entradas externas e trate o erro de parsing na fronteira da aplicação.
Interprete uma string personalizada de data e hora com DateTimeFormatter
Quando o valor segue um padrão como 15/06/2024 14:30:00, use DateTimeFormatter para interpretá-lo como LocalDateTime e, em seguida, passe esse objeto para Timestamp.valueOf(LocalDateTime). O padrão precisa corresponder à entrada: dd/MM/uuuu indica dia, mês e ano, enquanto HH:mm:ss usa o relógio de 24 horas. LocalDateTime não contém deslocamento UTC nem fuso horário; por isso, esse caminho preserva os campos de data e hora locais sem identificar um instante único.
import java.sql.Timestamp;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
public class CustomTimestamp {
public static void main(String[] args) {
String input = "15/06/2024 14:30:00";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu HH:mm:ss");
LocalDateTime localDateTime = LocalDateTime.parse(input, formatter);
Timestamp timestamp = Timestamp.valueOf(localDateTime);
}
}
Converta uma data interpretada em Timestamp com SimpleDateFormat
Em código legado baseado em java.util.Date, SimpleDateFormat pode interpretar um padrão personalizado. O parsing produz um objeto Date; getTime() retorna seu valor em milissegundos desde a época Unix, que pode ser passado ao construtor de Timestamp. Por padrão, SimpleDateFormat usa o fuso horário definido na JVM e permite datas inválidas por ajuste automático. Configure ambos explicitamente quando precisar de uma interpretação previsível. O exemplo define UTC e desativa esse ajuste. A API também é mutável e não é segura para uso concorrente; portanto, não compartilhe uma mesma instância entre operações simultâneas.
import java.sql.Timestamp;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.TimeZone;
public class LegacyTimestamp {
public static void main(String[] args) throws ParseException {
SimpleDateFormat formatter = new SimpleDateFormat("dd/MM/yyyy HH:mm:ss");
formatter.setTimeZone(TimeZone.getTimeZone("UTC"));
formatter.setLenient(false);
Date parsed = formatter.parse("15/06/2024 14:30:00");
Timestamp timestamp = new Timestamp(parsed.getTime());
}
}
Converta uma string que contém apenas a data em Timestamp com LocalDate.atStartOfDay()
Um valor que contém apenas a data não especifica um horário. Interprete-o como LocalDate, escolha a meia-noite como horário desejado com atStartOfDay() e converta o LocalDateTime resultante em Timestamp. Assim, a suposição fica explícita; a conversão não preserva um horário que não estava presente na entrada.
import java.sql.Timestamp;
import java.time.LocalDate;
import java.time.LocalDateTime;
public class DateOnlyTimestamp {
public static void main(String[] args) {
LocalDate date = LocalDate.parse("2024-06-15");
LocalDateTime startOfDay = date.atStartOfDay();
Timestamp timestamp = Timestamp.valueOf(startOfDay);
}
}
Escolha entre LocalDateTime e Timestamp
Use LocalDateTime quando o valor representar uma data e hora do calendário local e sua aplicação ainda não precisar atribuir um fuso horário. Use Timestamp quando uma API como JDBC exigir java.sql.Timestamp; esse tipo pode armazenar frações de segundo e representa um ponto na linha do tempo por meio de seu valor em milissegundos. A conversão de LocalDateTime usa o fuso horário padrão da JVM para calcular esse valor. Assim, os mesmos campos locais podem corresponder a instantes diferentes em máquinas com configurações padrão distintas.
Se a entrada especificar um deslocamento UTC ou uma região, interprete e mantenha essa informação usando um tipo java.time com suporte a deslocamento ou fuso horário antes de converter para um instante ou tipo de banco de dados. Nem Timestamp.valueOf() nem LocalDateTime conseguem inferir o fuso horário pretendido pelo remetente. Os tipos de coluna do banco de dados e os drivers JDBC também podem aplicar regras próprias de fuso horário; mantenha consistentes as suposições da aplicação ao armazenar e recuperar os valores.