Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Swift Swift Package Manager compatible Carthage compatible


Format your dates/times as emojis πŸ•Ÿ πŸ•‘ πŸ•—


You can build easy to understand user interfaces with EmojiTimeFormatter or can do funny things like that:


The example is accessable via Power of Emojis.


EmojiTimeFormatter supports multiple methods for installing the library in a project. You can find the latest version in the release tab.

Installation with Swift Package Manager

To integrate EmojiTimeFormatter into your Xcode project using Swift Package Manager, specify it in your Package.swift file:

import PackageDescription

let package = Package(
    dependencies: [
        .Package(url: "", majorVersion: XYZ)

Installation with Carthage

To integrate EmojiTimeFormatter into your Xcode project using Carthage, specify it in your Cartfile:

github "thomaspaulmann/EmojiTimeFormatter" ~> X.Y.Z

Run carthage update --toolchain to build the framework and drag the built EmojiTimeFormatter.framework into your Xcode project. It's important to specify your toolchain in the Xcode beta builds.

Installation without anything

To integrate EmojiTimeFormatter into your Xcode project using nothing but your hands, copy the Sources folder to your Xcode project. It's only two files and 200 lines of code.


You can convert dates to clock face emojis and vice versa.

Date to Emoji

Create a new EmojiTimeFormatter, get the ClockFaceEmoji for your Date and print it. It's that simple.

let now = Date()
let formatter = EmojiTimeFormatter()
let clockFaceEmoji = formatter.clockFace(from: now)

print("It's \(clockFaceEmoji) o'clock.") // Output: It's πŸ•’ o'clock.

Emoji to Date

It's also possible to convert a ClockFaceEmoji back to a Date. Create a new EmojiTimeFormatter, get the Date for your ClockFaceEmoji and print it. It's that simple, again.

let twelveThirty = ClockFaceEmoji.twelveThirty
let formatter = EmojiTimeFormatter()
let date = twelveThirty)

print("It's \(date).") // Output: It's 1970-01-01 00:30:00 +0000.

Note: Actually it's not a date, it's a time relative to 00:00:00 UTC on 1 January 1970.


This project is licensed under the MIT License - see the LICENSE file for details.


πŸ• Format your dates/times as emojis.




No packages published