Lesson 13 — Date and Time in Kotlin- Parsing and comparing
In the previous lesson, Date and Time in Kotlin — Modifying and intervals, we learned to convert between LocalDateTime , LocalDate , and LocalTime , modify the inner value, and introduced time intervals. In today’s Kotlin course tutorial, we’re going to finish with the topic of date and time. We’ll get inner values, parse using custom formats, and compare.
Retrieving the value
We read the value using properties, there’s nothing which should surprise us:
val halloween = LocalDate.of(2016, Month.OCTOBER, 31) println("Year: " + halloween.year + ", month: " + halloween.monthValue + ", day: " + halloween.dayOfMonth)
Notice that when IntelliJ displays autocomplete or when we press Ctrl + Space , the original Java methods the Kotlin’s properties originated from are shown on the left (in parentheses).
Year: 2016, month: 10, day: 31
Notice the use of the getMonthValue() to retrieve the month number. In this case, we had to use it because getMonth() would return the value of the enumerated Month type.
If you ever encounter the older Calendar class, beware that months were zero-based back then (January was 0 , not 1 like it is now in LocalDate / LocalDateTime ).
Parsing date and time
As you may already know, date and time often comes as a String, e.g. from the user through the console, a file or the database. We then create a LocalDateTime from the string value using the parse() method right on the data type as we’re used to in Kotlin.
The default parse() method expects dates to be in the yyyy-mm-dd format, date and times in the yyyy-mm-ddThh:mm:ss format and times in the hh:mm:ss format. All of the numbers have to have leading zeros if they’re less than 10. The T isn’t a typo. It’s more of a separator for date and time:
val dateTime = LocalDateTime.parse("2016-12-08T10:20:30") val date = LocalDate.parse("2016-12-08") val time = LocalTime.parse("10:20:30") println(dateTime.format(DateTimeFormatter.ofLocalizedDateTime(FormatStyle.MEDIUM))) println(date.format(DateTimeFormatter.ofLocalizedDate(FormatStyle.MEDIUM))) println(time.format(DateTimeFormatter.ofLocalizedTime(FormatStyle.MEDIUM)))
Console application Dec 8, 2016 10:20:30 AM Dec 8, 2016 10:20:30 AM Custom formats
Even more so, we’ll need to parse an American date and time or date and time in some other format. The default T separator for date and time isn’t very user-friendly
val dateTime = LocalDateTime.parse("12/08/2016 10:20:30", DateTimeFormatter.ofPattern("M/d/y HH:mm:ss")) val date = LocalDate.parse("12/8/2016", DateTimeFormatter.ofPattern("M/d/y")) val time = LocalTime.parse("10:20:30", DateTimeFormatter.ofPattern("H:m:ss")) println(dateTime.format(DateTimeFormatter.ofLocalizedDateTime(FormatStyle.MEDIUM))) println(date.format(DateTimeFormatter.ofLocalizedDate(FormatStyle.MEDIUM))) println(time.format(DateTimeFormatter.ofLocalizedTime(FormatStyle.MEDIUM)))
Dec 8, 2016 10:20:30 AM Dec 8, 2016 10:20:30 AM
Comparing instances
The easiest way to compare dates is using the operators < , and >= . Kotlin overloads these operators using compareTo() . We’ll talk about the compareTo() method in depth further in the course.
If it seems confusing to you, you can use the built-in methods from Java, which it contains because unlike Kotlin, it doesn’t support operator overloading. These methods start with is*() , let’s go through them:
- isAfter(date) — Returns whether the instance is after the date/date and time passed through the parameter (whether the value is greater).
- isBefore(date) — Returns whether the instance is before the date/date and time passed through the parameter (whether the value is lesser).
- isEqual(date) — Returns whether the instance is set to the same date and/or time as the instance passed through the parameter (whether the value is equal).
Easy enough, right? While on the topic of is*() methods, let’s go over the rest of them:
- isLeapYear — Returns whether the instance is set to a leap year or not.
- isSupported(ChronoUnit) — Returns whether the instance supports a given chrono unit (e.g. LocalDate won’t support ChronoUnit.HOURS since it doesn’t carry any time information).
In Java, isLeapYear() is a method, but Kotlin generated a property for us again.
Here’s an example of their use:
val halloween = LocalDate.of(2016, 10, 31) val christmas = LocalDate.of(2016, 12, 25) println("after: " + halloween.isAfter(christmas)); println("before: " + halloween.isBefore(christmas)) println("equals: " + christmas.isEqual(halloween)) println("equals: " + halloween.isEqual(halloween)) println("leap: " + halloween.isLeapYear) println("leap: " + halloween.withYear(2017).isLeapYear) println("supports hours: " + halloween.isSupported(ChronoUnit.HOURS)) println("supports years: " + halloween.isSupported(ChronoUnit.YEARS))
after: false before: true equals: false equals: true leap: true leap: false supports hours: false supports years: true
Other classes
Aside from LocalDateTime , LocalDate , and LocalTime , you may also encounter several other classes which you may find useful rather for applications which main purpose is date and time manipulation. Don’t worry, you’ll get by with LocalDateTime in most applications. However, you should be aware of the existence of the following classes.
Instant
Instant represents a date and time that is not related to the calendar or to daylight saving. It’s stored as a number of nanoseconds since 1/1/1970 , which gives it a certain point on the UTC (universal time) timeline. The following code will always print the same date and time no matter where you’re located on the planet:
val instantNow = Instant.now() println(instantNow)
Instant is only aware of universal time, so it’ll differ from a particular area’s local time.
OffsetDateTime and ZonedDateTime
Now you know that Instant is used for universal time and LocalDateTime is used for a particular area’s local time. We wouldn’t be able to get a point on a timeline from LocalDateTime since it doesn’t carry any area information.
Wouldn’t it be great if there was a class where date and time would be local and also carry the area information (timezone)? This way, we’d be able to convert between various time zones in a unified way. Well, that’s exactly what the ZonedDateTime class is there for.
In Kotlin, you may also encounter the OffsetDateTime class, which is an intermediate structure carrying the timezone offset. However, it comes without full timezone support.
ZoneId
In Kotlin, time zones are represented by the ZoneId class. Here’s an example of its use (creating an instance based on a time zone):
val localDateTime = ZonedDateTime.now(ZoneId.of("America/New_York)) println(localDateTime) 2016-12-09T04:30:41.597-05:00[America/New_York]
You may now be thinking, that’s a lot of classes. I suggest that you treat it rather as information to which you may return to when you need it. There are more classes in Kotlin than in many other programming languages. The best way to become a solid Kotlin programmer is to be patient and develop some endurance to the fact. On the other hand, this is why we’re better paid than others We’ll get to some more practical programming in the next lesson so as to take a break from the theoretical aspects of it all.
Epochas
To top it all off, we’ll get acquainted with some more LocalDateTime methods.
- ofEpochSecond() — A static method allowing us to create a LocalDateTime instance from a Linux timestamp which was used to store dates in the past. In returns the number of seconds since 1/1/1970 (the beginning of the Linux epoch), which is a huge number, and we also have to specify the nanoseconds (mostly 0) as well as the timezome (most often ZoneOffset.UTC ). The method is also available on LocalDate as ofEpochDay() where it receives the number of days rather than seconds.
- toEpochSecond() and toEpochDay() — These methods do the exact opposite of the ones mentioned above. They convert the instance to the number of seconds/days since 1970.
That is all for date and time in Kotlin. We’ll code a practical application in the next lesson, Diary with a database in Kotlin. It’ll be an electronic diary.
How to convert date string to timestamp in Kotlin?
Note that the example uses your system’s default timezone.
You’re maybe looking for the http://www.php.net/manual/en/function.strtotime.php function
$timestamp = strtotime("2011-08-04 15:00:01"); $timestamp += 6 * 3600; echo date('Y-m-d H:i:s', $timestamp); Here’s an example of how to convert DATETIME to UNIX timestamp:
SELECT UNIX_TIMESTAMP(STR_TO_DATE(‘Apr 15 2012 12:00AM’, ‘%M %d %Y %h:%i%p’))
Here’s an example of how to change date format:
SELECT FROM_UNIXTIME(UNIX_TIMESTAMP(STR_TO_DATE(‘Apr 15 2012 12:00AM’, ‘%M %d %Y %h:%i%p’)),’%m-%d-%Y %h:%i:%p’)
Documentation: UNIX_TIMESTAMP , FROM_UNIXTIME
date -j -f "%a %b %d %T %Z %Y" "Wed Jul 13 11:30:27 BST 2016" +"%s" 1468405827 I worked that out by telling date to output in the same format as you were using:
mongoimport is intended for importing data existing data in CSV, TSV, or JSON format. If you want to insert new fields (such as a created timestamp) you will have to set a value for them.
For example, if you want to set the created timestamp to the current time, you could get a unix timestamp from the command line (which will be seconds since the epoch):
The JSON representation that mongoimport expects is a 64-bit signed integer representing milliseconds since the epoch. You’ll need to multiply the unixtime seconds value by 1000 and include in your JSON file:
An alternative approach would be to add the created timestamps to documents after they have been inserted.
db.mycoll.update( >, // Query criteria < $set : < created: new Date() >>, // Add 'created' timestamp false, // upsert true // update all matching documents ) Kotlin localdate to timestamp
Kotlin is a cross-platform, statically typed, general-purpose programming language with type inference. It is a modern programming language that makes developers happier. It provides many date time functions to handle date time functionality.
Here we will explain Kotlin date time functions to get current epoch or Unix timestamp, convert timestamp to date and convert date to epoch or Unix timestamp.
- Epoch and Date Time Conversion in PHP
- Epoch and Date Time Conversion in JavaScript
- Epoch and Date Time Conversion in Perl
- Epoch and Date Time Conversion in Python
- Epoch and Date Time Conversion in Go
- Epoch and Date Time Conversion in Java
- Epoch and Date Time Conversion in Ruby
- Epoch and Date Time Conversion in MySQL
- Epoch and Date Time Conversion in SQL Server
- Epoch and Date Time Conversion in TypeScript
- Epoch and Date Time Conversion in VBA
- Epoch and Date Time Conversion in Rust
- Epoch and Date Time Conversion in Matlab
You can get the current unix timestamp using currentTimeMillis() .
Convert epoch or Unix timestamp to date in Kotlin
You can convert unix timestamp to date as follows.
val timeStamp = Timestamp(System.currentTimeMillis()) val date = Date(timeStamp.getTime())
Convert date to epoch or unix timestamp in Kotlin
You can convert the date to unix timestamp using following.
val date = SimpleDateFormat(«dd-MM-yyyy»).parse(«04-07-2021») println(date.time)