{"id":16322759,"url":"https://github.com/blackjacx/shdateformatter","last_synced_at":"2025-10-13T16:32:25.334Z","repository":{"id":11676886,"uuid":"70270117","full_name":"Blackjacx/SHDateFormatter","owner":"Blackjacx","description":"A date formatter supporting encoding as well as decoding of many different date and time formats including the often used ISO8601 standard.","archived":false,"fork":false,"pushed_at":"2025-01-22T17:31:53.000Z","size":637,"stargazers_count":5,"open_issues_count":8,"forks_count":4,"subscribers_count":3,"default_branch":"develop","last_synced_at":"2025-03-17T16:06:37.219Z","etag":null,"topics":["date","formatting","hacktoberfest","ios","swift","xcode"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Blackjacx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-10-07T17:54:19.000Z","updated_at":"2025-02-11T21:38:19.000Z","dependencies_parsed_at":"2024-10-28T15:12:06.959Z","dependency_job_id":"980fe230-8215-4181-aa01-9b3685f183e5","html_url":"https://github.com/Blackjacx/SHDateFormatter","commit_stats":{"total_commits":254,"total_committers":3,"mean_commits":84.66666666666667,"dds":"0.14566929133858264","last_synced_commit":"266f7bc4758d9f6cfbfa41e9d14535fa81f8b0d2"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blackjacx%2FSHDateFormatter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blackjacx%2FSHDateFormatter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blackjacx%2FSHDateFormatter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blackjacx%2FSHDateFormatter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Blackjacx","download_url":"https://codeload.github.com/Blackjacx/SHDateFormatter/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245023233,"owners_count":20548680,"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","formatting","hacktoberfest","ios","swift","xcode"],"created_at":"2024-10-10T22:52:21.976Z","updated_at":"2025-10-13T16:32:25.328Z","avatar_url":"https://github.com/Blackjacx.png","language":"Swift","funding_links":["https://www.paypal.me/STHEROLD"],"categories":[],"sub_categories":[],"readme":"\u003c!-- [![Test](https://github.com/Blackjacx/SHDateFormatter/actions/workflows/test.yml/badge.svg)](https://github.com/Blackjacx/SHDateFormatter/actions/workflows/test.yml) --\u003e\n\n[![Twitter Follow](https://img.shields.io/badge/follow-%40blackjacx-1DA1F2?logo=twitter\u0026style=for-the-badge)](https://twitter.com/intent/follow?original_referer=https%3A%2F%2Fgithub.com%2Fblackjacx\u0026screen_name=Blackjacxxx)\n[![Github Current Release](https://img.shields.io/github/release/blackjacx/SHDateFormatter.svg)](https://github.com/blackjacx/SHDateFormatter/releases)\n[![Swift Package Manager Compatible](https://img.shields.io/badge/SPM-compatible-brightgreen.svg)](https://swift.org/package-manager/)\n[![Swift Versions](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FBlackjacx%2FSHDateFormatter%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/Blackjacx/SHDateFormatter)\n[![Platforms](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FBlackjacx%2FSHDateFormatter%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/Blackjacx/SHDateFormatter)\n[![Xcode 13+](https://img.shields.io/badge/Xcode-13%2B-blue.svg)](https://developer.apple.com/download/)\n[![License](https://img.shields.io/github/license/blackjacx/SHDateFormatter.svg)](https://github.com/blackjacx/SHDateFormatter/blob/develop/LICENSE)\n[![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg?logo=paypal\u0026style=for-the-badge)](https://www.paypal.me/STHEROLD)\n\n\u003c!-- \u003cp align=\"center\"\u003e\n\u003cimg src=\"./icon.png\" alt=\"Source\" height=\"128\" width=\"128\"\u003e\n\u003c/p\u003e --\u003e\n\n# SHDateFormatter\n\nThis framework supports encoding as well as decoding many different date and time format. At the moment the following are supported (see SHDateFormat):\n\n- `shortWeekday` =\u003e Sun, Mon, Tue, ...\n- `longWeekday` =\u003e Sunday, Monday, Tuesday, ...\n- `shortMonth` =\u003e Jan, Feb, ...\n- `longMonth` =\u003e January, February, ...\n- `shortTimeNoDate` =\u003e 12:00 PM, 1:00 AM\n- `shortTimeMediumDate` =\u003e Jan 1, 2000 at 12:00 AM\n- `noTimeShortDateNoYear` =\u003e 12/31\n- `noTimeShortDate` =\u003e 12/02/2018\n- `noTimeLongDate` =\u003e December 2, 2018\n- `noTimeRelativeDate` =\u003e Today, Tomorrow, ...\n- `ISO8601` =\u003e \"yyyy'-'MM'-'dd'T'HH':'mm':'ss'Z'\" / \"yyyy'-'MM'-'dd'T'HH':'mm':'ss'+01:00'\" / etc.\n\nThe `ISO8601` format implements the standard for working with dates and times between client and server applications. A good explanation if this standard and how to work with it can be found in the [Apple Documenation](https://developer.apple.com/library/ios/qa/qa1480/_index.html) or on [Ole Begemanns Blog](http://oleb.net/blog/2011/11/working-with-date-and-time-in-cocoa-part-2/).\n\nAdditionally the following convenience functions are available on the SHDateFormatter sharedInstance which will return default values if the input date is nil. They allow to easily deal with optionals and can provide additional functionality like giving you a relative date instead of e.g. \"yyyy/MM/dd\":\n\n- `localizedTimeStringFromDate(_:)` - will return `--:--` per default\n- ... to be continued ...\n\n## Installation\n\n### [Swift Package Manager](https://swift.org/package-manager/)\n\nIn Xcode open your target list and select your project. Click the tab `Swift  Packages` and there the small `+` icon. Enter the URL of this repository, select the version you want to install - usually the preset is okay - and confirm.\n\n### [CocoaPods](http://cocoapods.org)\n\nI dropped CocoaPods support in favor of SPM from version `1.7.0`.\nPlease integrate the package via SPM (see above).\n\n### Carthage\n\nI dropped Carthage support in favor of SPM from version `1.7.0`.\nPlease integrate the package via SPM (see above).\n\n## Code Documentation\n\nThe [code documentation](https://swiftpackageindex.com/Blackjacx/SHDateFormatter/develop/documentation/shdateformatter) is generated and hosted by [Swift Package Index](https://swiftpackageindex.com/) (powered by [DocC](https://developer.apple.com/documentation/docc))\n\n## Release\n\nTo release this Swift package the following steps have to be taken:\n\n- Create a new branch `release-x.y.z`\n- Run `bash \u003c(curl -H -s https://raw.githubusercontent.com/Blackjacx/Scripts/master/frameworks/bootstrap.sh)` to update to the latest shared development files\n- Run `bundle update` to update all Ruby gems\n- Commit all changes, make a PR and merge it to develop\n- Run `bundle exec fastlane release framework:\"SHDateFormatter\" version:\"x.y.z\"` to release the new version\n- Post the following on Twitter\n\n```\nSHDateFormatter release x.y.z 🎉\n\n▸ 🚀  SHDateFormatter (x.y.z) successfully published\n▸ 📅  September 2nd\n▸ 🌎  https://swiftpackageindex.com/Blackjacx/SHDateFormatter\n▸ 🌎  https://github.com/Blackjacx/SHDateFormatter/releases/latest\n▸ 👍  Tell your friends!\n\n#SPM #Date #Formatter #tested\n```\n\n## Contribution\n\n- If you found a **bug**, please open an **issue**.\n- If you have a **feature request**, please open an **issue**.\n- If you want to **contribute**, please submit a **pull request**.\n\n## Author\n\n[Stefan Herold](mailto:stefan.herold@gmail.com) • 🐦 [@Blackjacxxx](https://twitter.com/Blackjacxxx)\n\n## Contributors\n\nThanks to all of you who are part of this:\n\n\u003ca href=\"https://github.com/blackjacx/SHDateFormatter/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=blackjacx/SHDateFormatter\" /\u003e\n\u003c/a\u003e\n\n## License\n\nSHDateFormatter is available under the MIT license. See the [LICENSE](LICENSE) file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackjacx%2Fshdateformatter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackjacx%2Fshdateformatter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackjacx%2Fshdateformatter/lists"}