Timestamp Parser

Last updated:

This app parses the timestamp of each event that comes in to PostHog and adds the following time-based properties:

PropertyDescriptionExample
day_of_the_weekPlain text value for the day of the weekMonday
dayNumeric value for the day within a month7
monthNumeric value corresponding to the current month6 (June)
yearNumeric value of the year2022
hourNumeric value for the hour in UTC (24-hour clock)21
minuteNumeric value for the minute37

Example event

Here is an example of what these properties look like after they have been added to an event.

event with timestamp properties added

Installation

PostHog Cloud

PostHog Cloud users can find the app here and click on the toggle to enable the app. Once the app has been enabled, it will automatically start parsing all new events which come in to PostHog.

PostHog Self-hosted

The Timestamp Parser requires a PostHog instance running version 1.30.0 or later. Not running 1.30.0? Find out how to update.

  1. Visit the 'Apps' page in your instance of PostHog.
  2. Search for 'Timestamp Parser'.
  3. Click on the toggle to enable the app.

Any new events that come in to PostHog will now be automatically parsed!

Using the Timestamp Parser

The timestamp parser is a great tool for answering time-based questions that are sometimes very challenging to tackle with PostHog alone.

By filtering and breaking down events, we can now easily answer questions such as:

  • Do we get more purchases on weekdays or weekends?
  • Why does our traffic spike on Tuesdays?
  • How do users use our platform differently during the holiday season?
  • How does retention compare for users who join on a weekend versus a weekday?

Note: This app only works on new events sent to PostHog, and as a result you won't be able to filter events that were sent before it was enabled.

Examples

Here's an example of creating a filter in a trends insight to only show events that were send on a Saturday or Sunday.

filter for only events on Saturday or Sunday

We can also break down an insight by month to get an idea of how it varies over the course of a year.

breaking down an insight by month

Overall, the timestamp parser is a simple yet incredibly powerful app that these examples only scratch the surface on.

Have a question?

We love answering questions. Ask us anything via our Support page or using the Q&A widget at the bottom of this page.

You can also join the PostHog Community Slack group to collaborate with others and get advice on developing your own PostHog apps.

Further information

Who created this app?

We'd like to thank PostHog team member Yakko Majuri and community member Victor Campuzano for creating the Timestamp Parser. Thank you, both!

What if I have feedback on this app?

We love feature requests and feedback! Please create an issue to tell us what you think.

Questions?

Was this page useful?

Next article

URL Normalizer

What does the URL Normalizer app do? This app normalizes the format of URLs so you can more easily compare them in insights. By default, the URL Normalizer converts all URLs to lowercase and strips trailing /s, overriding the old current_url property. What are the requirements for this app? The URL Normalizer app requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later. Not running 1.30.0? Find out how to update your self-hosted PostHog deployment…

Read next article