{"id":20475300,"url":"https://github.com/vim-utilities/date-time","last_synced_at":"2026-03-08T17:32:39.733Z","repository":{"id":181324289,"uuid":"615851928","full_name":"vim-utilities/date-time","owner":"vim-utilities","description":"Commands for injecting date and/or time into current buffer","archived":false,"fork":false,"pushed_at":"2023-03-18T21:34:34.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-16T03:14:59.230Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Vim Script","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vim-utilities.png","metadata":{"files":{"readme":".github/README.md","changelog":null,"contributing":null,"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":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"liberapay":"vim-utilities"}},"created_at":"2023-03-18T21:29:47.000Z","updated_at":"2023-03-18T21:30:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"65bba13e-2cc6-4fd3-836a-b2a78631c3b1","html_url":"https://github.com/vim-utilities/date-time","commit_stats":null,"previous_names":["vim-utilities/date-time"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vim-utilities%2Fdate-time","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vim-utilities%2Fdate-time/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vim-utilities%2Fdate-time/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vim-utilities%2Fdate-time/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vim-utilities","download_url":"https://codeload.github.com/vim-utilities/date-time/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242042056,"owners_count":20062340,"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":[],"created_at":"2024-11-15T15:15:38.399Z","updated_at":"2026-03-08T17:32:39.690Z","avatar_url":"https://github.com/vim-utilities.png","language":"Vim Script","funding_links":["https://liberapay.com/vim-utilities"],"categories":[],"sub_categories":[],"readme":"# Date Time\n[heading__top]:\n  #date-time\n  \"\u0026#x2B06; Commands for injecting date and/or time into current buffer\"\n\n\nCommands for injecting date and/or time into current buffer\n\n## [![Byte size of Date Time][badge__main__date_time__source_code]][date_time__main__source_code] [![Open Issues][badge__issues__date_time]][issues__date_time] [![Open Pull Requests][badge__pull_requests__date_time]][pull_requests__date_time] [![Latest commits][badge__commits__date_time__main]][commits__date_time__main] [![License][badge__license]][branch__current__license]\n\n\n---\n\n\n- [:arrow_up: Top of Document][heading__top]\n\n- [:building_construction: Requirements][heading__requirements]\n\n- [:zap: Quick Start][heading__quick_start]\n\n- [\u0026#x1F9F0; Usage][heading__usage]\n\n  - [Replace selection example][heading__replace_selection_example]\n  - [Insert and append examples][heading__insert_and_append_examples]\n\n- [\u0026#x1F5D2; Notes][heading__notes]\n\n- [:chart_with_upwards_trend: Contributing][heading__contributing]\n\n  - [:trident: Forking][heading__forking]\n  - [:currency_exchange: Sponsor][heading__sponsor]\n\n- [:card_index: Attribution][heading__attribution]\n\n- [:balance_scale: Licensing][heading__license]\n\n\n---\n\n\n\n## Requirements\n[heading__requirements]:\n  #requirements\n  \"\u0026#x1F3D7; Prerequisites and/or dependencies that this project needs to function properly\"\n\n\nThis repository requires the [Vim][vim_home] text editor to be installed the source code is available on [GitHub -- `vim/vim`][vim__github], and most GNU Linux package managers are able to install Vim directly, eg...\n\n\n- Arch based Operating Systems\n\n\n```Bash\nsudo packman -Syy\n\nsudo packman -S vim\n```\n\n\n- Debian derived Distributions\n\n\n```Bash\nsudo apt-get update\n\nsudo apt-get install vim\n```\n\n\n______\n\n\n## Quick Start\n[heading__quick_start]:\n  #quick-start\n  \"\u0026#9889; Perhaps as easy as one, 2.0,...\"\n\n\nThis repository is a Vim plugin and can be installed via a number of methods.\n\n\n0. [Source][date_time__main__source_code]\n\n   ```Bash\n   mkdir -p ~/git/hub/vim-utilities\n\n   cd ~/git/hub/vim-utilities/date-time\n\n   git clone git@github.com:vim-utilities/date-time.git\n\n   make install\n   ```\n\n\n1. [Plug](https://github.com/junegunn/vim-plug)\n\n   **`~/.vimrc` (snip)**\n\n   ```vim\n   call plug#begin('~/.vim/plugged')\n     \" ...\n     Plug 'vim-utilities/date-time'\n     \" ...\n   call plug#end()\n   ```\n\n   After adding above `Plug` line to your Vim configuration file, run the following `PlugInstall` Ex mode command within a Vim session\n\n   ```vim\n   :PlugInstall date-time\n   ```\n\n\n2. [Vundle](https://github.com/VundleVim/Vundle.vim)\n\n   **`~/.vimrc` (snip)**\n\n   ```vim\n   call vundle#begin('~/.vim/plugged')\n     \" ...\n     Plugin 'vim-utilities/date-time'\n     \" ...\n   call vundle#end()\n   ```\n\n   After adding above `Plugin` line to your Vim configuration file, run the following `PluginInstall` Ex mode command within a Vim session\n\n   ```vim\n   :PluginInstall\n   ```\n\n\n______\n\n\n## Usage\n[heading__usage]:\n  #usage\n  \"\u0026#x1F9F0; How to utilize this repository\"\n\n\nAfter installation use `help` to review configuration, and usage, details, eg.\n\n\n```vim\n:help date-time.txt\n\n\" Jump to specific sections\n:help date-time-ex-commands\n:help date-time-normal-map\n:help date-time-visual-map\n:help date-time-configuration\n:help date-time-notes\n```\n\n\nAlternatively plugin documentation maybe reviewed within\n[`doc/date-time.txt`][branch__current__doc__date_time] file.\n\n\n---\n\n\n### Replace selection example\n[heading__replace_selection_example]: #replace-selection-example\n\n\nBy default the `\u003cLeader\u003eR` sequence in Visual select mode will _`R`eplace_ any\ndate/time format strings.\n\n\nConsider the following template time-sheet CSV;\n\n```csv\ndate,start,stop,description\n\n%F,%R,%R,DESCRIPTION\n```\n\n... which can be quickly modified via the following sequence of steps;\n\n\n- **Normal mode**\n  - `G` normal mode we can jump to the end of the buffer\n  - `yy` to yank the whole line\n  - `gg` to jump to the top of the buffer\n  - `P` to put/past before cursor position\n  - `v` to enter Visual select mode\n\n\n- **Visual mode**\n  - `t,;` select _`t`ill_ comma (`,`) and `;` to repeat once\n  - `\u003cLeader\u003eR`\n  - selected `%F,%R` text will be replaced via `strftime` built-in function\n\n\u003e Note; mode will automatically switch to Normal\n\n\n**Example result**\n\n```csv\ndate,start,stop,description\n2023-03-18,14:04,%R,DESCRIPTION\n\n%F,%R,%R,DESCRIPTION\n```\n\n\n---\n\n\n### Insert and append examples\n[heading__insert_and_append_examples]: #insert-and-append-examples\n\n\nBy default Normal mode `\u003cLeader\u003et` (or `T`), and `\u003cLeader\u003ed` (or `D`), motions\nwill append or insert the current time or date respectively.\n\n\u003e Tip; this can be useful in combination with \u003ckbd\u003eCtrl\u003c/kbd\u003e^\u003ckbd\u003eo\u003c/kbd\u003e from\n\u003e Insert mode to avoid breaking one's flow of thought.\n\n\nConsider the following text;\n\n```text\nI will see you later today (\n```\n\n... which may have current date appended via the following sequence of steps;\n\n\n- **Insert mode**\n  - \u003ckbd\u003eCtrl\u003c/kbd\u003e^\u003ckbd\u003eo\u003c/kbd\u003e\n\n- **(insert)/Normal mode**\n  - `\u003cLeader\u003ed`\n\n- **Insert mode**\n  - `) to discuss something`\n\n\n**Example result**\n\n```text\nI will see you later today (2023-03-18) to discuss something\n```\n\n\n______\n\n\n## Notes\n[heading__notes]:\n  #notes\n  \"\u0026#x1F5D2; Additional things to keep in mind when developing\"\n\n\nThis repository may not be feature complete and/or fully functional, Pull\nRequests that add features or fix bugs are certainly welcomed.\n\n\n\n______\n\n\n## Contributing\n[heading__contributing]:\n  #contributing\n  \"\u0026#x1F4C8; Options for contributing to date-time and vim-utilities\"\n\n\nOptions for contributing to date-time and vim-utilities\n\n\n---\n\n\n### Forking\n[heading__forking]:\n  #forking\n  \"\u0026#x1F531; Tips for forking date-time\"\n\n\nStart making a [Fork][date_time__fork_it] of this repository to an account that you have write permissions for.\n\n\n- Add remote for fork URL. The URL syntax is _`git@github.com:\u003cNAME\u003e/\u003cREPO\u003e.git`_...\n\n\n```Bash\ncd ~/git/hub/vim-utilities/date-time\n\ngit remote add fork git@github.com:\u003cNAME\u003e/date-time.git\n```\n\n\n- Commit your changes and push to your fork, eg. to fix an issue...\n\n\n```Bash\ncd ~/git/hub/vim-utilities/date-time\n\n\ngit commit -F- \u003c\u003c'EOF'\n:bug: Fixes #42 Issue\n\n\n**Edits**\n\n\n- `\u003cSCRIPT-NAME\u003e` script, fixes some bug reported in issue\nEOF\n\n\ngit push fork main\n```\n\n\n\u003e Note, the `-u` option may be used to set `fork` as the default remote, eg. _`git push -u fork main`_ however, this will also default the `fork` remote for pulling from too! Meaning that pulling updates from `origin` must be done explicitly, eg. _`git pull origin main`_\n\n\n- Then on GitHub submit a Pull Request through the Web-UI, the URL syntax is _`https://github.com/\u003cNAME\u003e/\u003cREPO\u003e/pull/new/\u003cBRANCH\u003e`_\n\n\n\u003e Note; to decrease the chances of your Pull Request needing modifications before being accepted, please check the [dot-github](https://github.com/vim-utilities/.github) repository for detailed contributing guidelines.\n\n\n---\n\n\n### Sponsor\n  [heading__sponsor]:\n  #sponsor\n  \"\u0026#x1F4B1; Methods for financially supporting vim-utilities that maintains date-time\"\n\n\nThanks for even considering it!\n\n\nVia Liberapay you may \u003csub\u003e[![sponsor__shields_io__liberapay]][sponsor__link__liberapay]\u003c/sub\u003e on a repeating basis.\n\n\nRegardless of if you're able to financially support projects such as date-time that vim-utilities maintains, please consider sharing projects that are useful with others, because one of the goals of maintaining Open Source repositories is to provide value to the community.\n\n\n______\n\n\n## Attribution\n[heading__attribution]:\n  #attribution\n  \"\u0026#x1F4C7; Resources that where helpful in building this project so far.\"\n\n\n- [GitHub -- `github-utilities/make-readme`](https://github.com/github-utilities/make-readme)\n\n\n______\n\n\n## License\n[heading__license]:\n  #license\n  \"\u0026#x2696; Legal side of Open Source\"\n\n\n```\nCommands for injecting date and/or time into current buffer\nCopyright (C) 2023 S0AndS0\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU Affero General Public License as published\nby the Free Software Foundation, version 3 of the License.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU Affero General Public License for more details.\n\nYou should have received a copy of the GNU Affero General Public License\nalong with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n\n```\n\n\nFor further details review full length version of [AGPL-3.0][branch__current__license] License.\n\n\n\n[branch__current__license]:\n  /LICENSE\n  \"\u0026#x2696; Full length version of AGPL-3.0 License\"\n\n[branch__current__doc__date_time]:\n  /doc/date-time.txt\n  \"`:help date-time.txt` plugin documentation\"\n\n[badge__license]:\n  https://img.shields.io/github/license/vim-utilities/date-time\n\n[badge__commits__date_time__main]:\n  https://img.shields.io/github/last-commit/vim-utilities/date-time/main.svg\n\n[commits__date_time__main]:\n  https://github.com/vim-utilities/date-time/commits/main\n  \"\u0026#x1F4DD; History of changes on this branch\"\n\n\n[date_time__community]:\n  https://github.com/vim-utilities/date-time/community\n  \"\u0026#x1F331; Dedicated to functioning code\"\n\n\n[issues__date_time]:\n  https://github.com/vim-utilities/date-time/issues\n  \"\u0026#x2622; Search for and _bump_ existing issues or open new issues for project maintainer to address.\"\n\n[date_time__fork_it]:\n  https://github.com/vim-utilities/date-time/fork\n  \"\u0026#x1F531; Fork it!\"\n\n[pull_requests__date_time]:\n  https://github.com/vim-utilities/date-time/pulls\n  \"\u0026#x1F3D7; Pull Request friendly, though please check the Community guidelines\"\n\n[date_time__main__source_code]:\n  https://github.com/vim-utilities/date-time/\n  \"\u0026#x2328; Project source!\"\n\n[badge__issues__date_time]:\n  https://img.shields.io/github/issues/vim-utilities/date-time.svg\n\n[badge__pull_requests__date_time]:\n  https://img.shields.io/github/issues-pr/vim-utilities/date-time.svg\n\n[badge__main__date_time__source_code]:\n  https://img.shields.io/github/repo-size/vim-utilities/date-time\n\n\n[vim__home]:\n  https://www.vim.org\n  \"Home page for the Vim text editor\"\n\n[vim__github]:\n  https://github.com/vim/vim\n  \"Source code for Vim on GitHub\"\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvim-utilities%2Fdate-time","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvim-utilities%2Fdate-time","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvim-utilities%2Fdate-time/lists"}