Yes, we're now running our Black Friday Sale. All Access and Pro are 33% off until 2nd December, 2025:
Convert Google Protocol Buffer Timestamp to LocalDate
Last updated: March 19, 2025
Modern software architecture is often broken. Slow delivery leads to missed opportunities, innovation is stalled due to architectural complexities, and engineering resources are exceedingly expensive.
Orkes is the leading workflow orchestration platform built to enable teams to transform the way they develop, connect, and deploy applications, microservices, AI agents, and more.
With Orkes Conductor managed through Orkes Cloud, developers can focus on building mission critical applications without worrying about infrastructure maintenance to meet goals and, simply put, taking new products live faster and reducing total cost of ownership.
Try a 14-Day Free Trial of Orkes Conductor today.
Modern software architecture is often broken. Slow delivery leads to missed opportunities, innovation is stalled due to architectural complexities, and engineering resources are exceedingly expensive.
Orkes is the leading workflow orchestration platform built to enable teams to transform the way they develop, connect, and deploy applications, microservices, AI agents, and more.
With Orkes Conductor managed through Orkes Cloud, developers can focus on building mission critical applications without worrying about infrastructure maintenance to meet goals and, simply put, taking new products live faster and reducing total cost of ownership.
Try a 14-Day Free Trial of Orkes Conductor today.
Mocking is an essential part of unit testing, and the Mockito library makes it easy to write clean and intuitive unit tests for your Java code.
Get started with mocking and improve your application tests using our Mockito guide:
Spring 5 added support for reactive programming with the Spring WebFlux module, which has been improved upon ever since. Get started with the Reactor project basics and reactive programming in Spring Boot:
Since its introduction in Java 8, the Stream API has become a staple of Java development. The basic operations like iterating, filtering, mapping sequences of elements are deceptively simple to use.
But these can also be overused and fall into some common pitfalls.
To get a better understanding on how Streams work and how to combine them with other language features, check out our guide to Java Streams:
Explore Spring Boot 3 and Spring 6 in-depth through building a full REST API with the framework:
Yes, Spring Security can be complex, from the more advanced functionality within the Core to the deep OAuth support in the framework.
I built the security material as two full courses - Core and OAuth, to get practical with these more complex scenarios. We explore when and how to use each feature and code through it on the backing project.
You can explore the course here:
Modern software architecture is often broken. Slow delivery leads to missed opportunities, innovation is stalled due to architectural complexities, and engineering resources are exceedingly expensive.
Orkes is the leading workflow orchestration platform built to enable teams to transform the way they develop, connect, and deploy applications, microservices, AI agents, and more.
With Orkes Conductor managed through Orkes Cloud, developers can focus on building mission critical applications without worrying about infrastructure maintenance to meet goals and, simply put, taking new products live faster and reducing total cost of ownership.
Try a 14-Day Free Trial of Orkes Conductor today.
Spring Data JPA is a great way to handle the complexity of JPA with the powerful simplicity of Spring Boot.
Get started with Spring Data JPA through the guided reference course:
Refactor Java code safely — and automatically — with OpenRewrite.
Refactoring big codebases by hand is slow, risky, and easy to put off. That’s where OpenRewrite comes in. The open-source framework for large-scale, automated code transformations helps teams modernize safely and consistently.
Each month, the creators and maintainers of OpenRewrite at Moderne run live, hands-on training sessions — one for newcomers and one for experienced users. You’ll see how recipes work, how to apply them across projects, and how to modernize code with confidence.
Join the next session, bring your questions, and learn how to automate the kind of work that usually eats your sprint time.
Yes, we're now running our Black Friday Sale. All Access and Pro are 33% off until 2nd December, 2025:
1. Overview
The Protocol Buffer (protobuf) data format helps us transfer structured data over a network. It’s independent of any programming language and has an implementation for most programming languages, including Java.
The protobuf Timestamp type represents a point in time, independent of any specific time zone. Time is a crucial component in computing, and there may be a case in which we need to convert the protobuf Timestamp to a Java time instance, such as LocalDate, to seamlessly integrate it into an existing Java codebase.
In this tutorial, we’ll explore the process of converting a protobuf Timestamp instance to the LocalDate type, enabling us to work with protobuf data more efficiently within Java applications.
2. Maven Dependency
To create an instance of Timestamp or make use of code generated from .proto file, we need to add protobuf-java dependency to the pom.xml:
<dependency>
<groupId>com.google.protobuf</groupId>
<artifactId>protobuf-java</artifactId>
<version>4.26.1</version>
</dependency>
The dependency provides a Timestamp class and other protobuf-related classes.
3. The Timestamp Class
The protobuf Timestamp class represents a point in time since the Unix epoch. The time zone or the local calendar does not influence it.
It’s represented as a count of seconds and nanoseconds at a point in time. Let’s see an example that computes the current Timestamp by using a Java Instant object:
Instant currentTimestamp = Instant.now();
Timestamp timestamp = Timestamp.newBuilder()
.setSeconds(currentTimestamp.getEpochSecond())
.setNanos(currentTimestamp.getNano())
.build();In the code above, we compute the Timestamp from the Instant object. First, we create an Instant object that represents date and time at a given point. Next, we extract the seconds and nanoseconds and pass them to the Timestamp instance.
4. Convert Timestamp Instance to LocalDate
When converting from Timestamp to LocalDate, it’s crucial to consider the time zone and its associated offset from UTC to accurately represent the local date. To convert Timestamp to LocalDate, let’s start by creating a Timestamp instance with a specific set of seconds and nanoseconds:
Timestamp ts = Timestamp.newBuilder()
.setSeconds(1000000)
.setNanos(77886600)
.build();Since the Instant class is the most suitable representation for a point in time, let’s create a method that accepts the Timestamp as an argument and converts it to LocalDate:
LocalDate convertToLocalDate(Timestamp timestamp) {
Instant instant = Instant.ofEpochSecond(timestamp.getSeconds(), timestamp.getNanos());
LocalDate time = instant.atZone(ZoneId.of("America/Montreal")).toLocalDate();
return time;
}In the code above, we create an Instant object from the Timestamp by using the ofEpochSecond() method, which takes the seconds and nanoseconds from the Timestamp as an argument.
Then, we convert the Instant object to LocalDate by using the atZone() method, which allows us to specify the time zone. This is essential because it ensures the resulting LocalDate reflects the time zone offset.
Notably, we can also use our default system time zone:
LocalDate time = instant.atZone(ZoneId.systemDefault()).toLocalDate();
Let’s write a unit test to assert the logic:
@Test
void givenTimestamp_whenConvertedToLocalDate_thenSuccess() {
Timestamp timestamp = Timestamp.newBuilder()
.setSeconds(1000000000)
.setNanos(778866000)
.build();
LocalDate time = TimestampToLocalDate.convertToLocalDate(timestamp);
assertEquals(LocalDate.of(2001, 9, 9), time);
}In the code above, we assert that the LocalDate from the conversion matches the expected result.
5. Conclusion
In this tutorial, we learned how to convert from Timestamp to LocalDate by converting to Instant to represent a point in time. Also, we converted an Instance object to a LocalDate type by setting the time zone to deal with possible offset.
The code backing this article is available on GitHub. Once you're logged in as a Baeldung Pro Member, start learning and coding on the project.
