Skip to content
VimL Makefile
Latest commit 32c474d Aug 31, 2015 @mattn Merge pull request #27 from osleg/master
Added option to customize calendar's diary file extension
Failed to load latest commit information.
autoload Removed unneeded expand() Aug 29, 2015
doc Correct misspelling Aug 26, 2015
plugin Issue #10 Oct 27, 2013
.gitignore Add .gitignore Mar 19, 2013
Makefile Add Makefile Mar 26, 2013 Fixes doc, close #16 Jul 8, 2013
calendar.vim.vimup Fix vimup source Mar 26, 2013


calendar.vim creates a calendar window you can use within vim. It is useful in its own right as a calendar-inside-vim. It also provides hooks to customise its behaviour, making it a good basis for writing new plugins which require calendar functionality (see :help calendar-hooks for more information).


You can install calendar.vim in the usual way, by copying the contents of the plugin, autoload and doc directories into the equivalent directories inside .vim.

Alternatively, if you manage your plugins using pathogen.vim, you can simply clone into the bundle directory:

cd ~/.vim/bundle
git clone git://

Or, using submodules:

cd ~/.vim
git submodule add git:// bundle/calendar-vim


Bring up a calendar based on today's date in a vertically split window:


Bring up a calendar showing November, 1991 (The month Vim was first released):

:Calendar 1991 11

The above calendars can alternatively be displayed in a horizontally split window:


Bring up a full-screen:


Fast mappings are provided:

  • <LocalLeader>cal: Vertically-split calendar
  • <LocalLeader>caL: Horizontally-split calendar

For full documentation, install the plugin and run :help calendar from within Vim.

Something went wrong with that request. Please try again.