{"id":13496656,"url":"https://github.com/vi/timeago","last_synced_at":"2025-04-05T07:07:41.395Z","repository":{"id":23891958,"uuid":"100107005","full_name":"vi/timeago","owner":"vi","description":"In Rust, format Duration into a string like \"1 hour ago\" or \"01hou\".","archived":false,"fork":false,"pushed_at":"2023-09-18T11:43:01.000Z","size":122,"stargazers_count":65,"open_issues_count":4,"forks_count":17,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-04-24T15:19:05.903Z","etag":null,"topics":["date","duration","formatting","rust-library","time","timeago"],"latest_commit_sha":null,"homepage":"https://docs.rs/timeago/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-08-12T11:05:54.000Z","updated_at":"2024-04-10T12:38:07.000Z","dependencies_parsed_at":"2024-01-14T10:59:32.081Z","dependency_job_id":"de2686a2-6c52-4254-a1d8-ad39f8b07d99","html_url":"https://github.com/vi/timeago","commit_stats":{"total_commits":95,"total_committers":17,"mean_commits":5.588235294117647,"dds":0.2315789473684211,"last_synced_commit":"e9fb6f02179f86190815eff22d422dc286ca3a07"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vi%2Ftimeago","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vi%2Ftimeago/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vi%2Ftimeago/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vi%2Ftimeago/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vi","download_url":"https://codeload.github.com/vi/timeago/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247299833,"owners_count":20916190,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["date","duration","formatting","rust-library","time","timeago"],"created_at":"2024-07-31T19:01:55.279Z","updated_at":"2025-04-05T07:07:41.372Z","avatar_url":"https://github.com/vi.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"# timeago\nIn Rust, format Duration into string like \"1 hour ago\" or \"01hou\".\n\nCurrently it does not [take the calendar into account](https://github.com/vi/timeago/issues/12) and assumes each month is about 30.4 days long.\n\nParsing such string back to a `Duration` is out of scope for this crate. Maybe see the [`chrono-english`](https://docs.rs/chrono-english) crate instead.\n\nWith `isolang` feature off, it supports Rust from version 1.24.\n\n## API\n\n[Documentation link](https://docs.rs/timeago/)\n\nSimplified API excerpt (pseudocode):\n\n```rust\npub struct Formatter\u003cL : Language = English\u003e{...}\n\nimpl Formatter {\n    pub fn new() -\u003e Formatter\u003cEnglish\u003e;\n    pub fn with_language(l: Language) -\u003e Self;\n    pub fn num_items(\u0026mut self, x: usize) -\u003e \u0026mut Self;\n    pub fn max_unit(\u0026mut self, x: TimeUnit) -\u003e \u0026mut Self;\n    pub fn min_unit(\u0026mut self, x: TimeUnit) -\u003e \u0026mut Self;\n    pub fn too_low(\u0026mut self, x: \u0026'static str) -\u003e \u0026mut Self;\n    pub fn too_high(\u0026mut self, x: \u0026'static str) -\u003e \u0026mut Self;\n    pub fn max_duration(\u0026mut self, x: Duration) -\u003e \u0026mut Self;\n    pub fn ago(\u0026mut self, x: \u0026'static str) -\u003e \u0026mut Self;\n    \n    pub fn convert(\u0026self, d: Duration) -\u003e String;\n    pub fn convert_chrono(\u0026self, from: chrono::DateTime, to: chrono::DateTime) -\u003e String;\n}\n\npub fn from_isolang(x : isolang::Language) -\u003e Option\u003cBox\u003cLanguage\u003e\u003e;\n\npub fn format_5chars(d: Duration) -\u003e String;\n```\n\nA `Language` can be constructed from [isolang::Language](https://docs.rs/isolang/1/isolang/enum.Language.html).\n\n## Translations\n\n* English\n* Russian\n* French\n* Portuguese (contributed)\n* German (unchecked)\n* Belarusian (unchecked)\n* Polish (unchecked)\n* Spanish (contributed)\n* Chinese (contributed)\n* Romanian (contributed)\n* Swedish (contributed)\n* Turkish (contributed)\n* Japanese (contributed)\n* Danish (contributed)\n* Italian (contributed)\n* Ukrainian (contributed)\n\nIf you checked some language and certify that it's allright, submit a pull request that removes \"(unchecked)\" or \"(contributed)\" in the list above.\n\n## Tool\n\nThere is a helper command line tool that allows easier experimenting when adding a new translation:\n\n```\n$ cargo run --features isolang en\n    Finished dev [unoptimized + debuginfo] target(s) in 0.0 secs\n     Running `target/debug/timeago en`\n60\n1 minute ago\n7200\n2 hours ago\n```\n\n# See also\n\n* [chrono-humanize](https://docs.rs/crate/chrono-humanize)\n* compound_duration - split `Duration` into weeks/days/minues/etc. parts\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvi%2Ftimeago","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvi%2Ftimeago","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvi%2Ftimeago/lists"}