humane-ruby

Getting human-readable file sizes with 1000-based math (as the Mac Finder displays) and relative times worded the way Swift's RelativeDateTimeFormatter does turned out to be a real challenge to get both right and simple. The humane library exists so a Ruby application can share consistent size and time formatting with a Swift application, instead of reaching for a library whose output doesn't match Swift's or that's complicated to drop in.

require "humane"

Humane::SizeFormatter.new.string(from_byte_count: 225_935) # "226 KB"

time_formatter = Humane::TimeFormatter.new
time_formatter.string(at: Time.now - 180, relative_to: Time.now) # "3 minutes ago"

Corresponding functions in Swift will have consistent output.

import Foundation

ByteCountFormatter.string(fromByteCount: Int64(225935), countStyle: .file) // "226 KB"

let formatter = RelativeDateTimeFormatter(); formatter.unitsStyle = .full
formatter.localizedString(for: time, relativeTo: now) // "3 minutes ago"

Install

gem install humane

or in a Gemfile:

gem "humane"

Scope

Finder's .file byte-count style, and a numeric (non-calendar-aware) relative time style -- that's the whole surface area today. allowed_units/alternate count_styles and a :named style ("yesterday", calendar-boundary-aware) aren't implemented -- contributions welcome.