How to convert Unix timestamp to Datetime in Ballerina

🎈 🎈 🎈


    import ballerina/time;

    public function main() {
        int unixTimestamp = 914766802;
        time:Utc unixTime = time:utcFromUnix(unixTimestamp);
        string formattedDate = time:format(unixTime, "yyyy-MM-dd HH:mm:ss");
        io:println("Converted Date: ", formattedDate);
    }

Output:

Converted Date: 1998-12-27 13:53:22

Example only. There may be multiple ways to perform this operation.

Code Explanation

In this Ballerina example, time:utcFromUnix is used to convert a Unix timestamp (seconds since January 1, 1970) to a Utc structure. The time:format function then converts this Utc time into a human-readable string in the 'YYYY-MM-DD HH:MM:SS' format.

Convert Date to Unix timestamp in Ballerina

Other useful Ballerina date functions

Function	Description	Example
`time:currentTime()`	Returns the current UTC time as a `time:Utc` structure.	`time:currentTime()` returns Utc{2024-09-05T14:55:00Z}
`time:utcFromUnix(seconds)`	Converts a Unix timestamp to a `time:Utc` structure.	`time:utcFromUnix(1609459200)` returns Utc{2021-01-01T00:00:00Z}
`time:toUnix(time)`	Converts a `time:Utc` structure to a Unix timestamp.	`time:toUnix(time:currentTime())` returns 1693227296
`time:format(time, format)`	Formats a `time:Utc` structure into a custom string format.	`time:format(time:currentTime(), "yyyy-MM-dd HH:mm:ss")` returns 2024-09-05 14:55:00
`time:addDuration(time, duration)`	Adds a duration (e.g., hours, minutes) to a `time:Utc` structure.	`time:addDuration(time:currentTime(), {hours: 1})` adds 1 hour to the current time.

Current Unix Timestamp SECONDS SINCE JAN 01 1970

Current UTC Time

2025-08-21