Gem Version Build Status

gem to create a new file in the Excel 2007+ XLSX format, and you can use the same interface as writeexcel gem. write_xlsx is converted from Perl's module Excel::Writer::XLSX-0.84 .


Reference doc : http://cxn03651.github.io/write_xlsx/

The WriteXLSX supports the following features:

  • Multiple worksheets
  • Strings and numbers
  • Unicode text
  • Cell formatting
  • Formulas (including array formats)
  • Images
  • Charts
  • Autofilters
  • Data validation
  • Conditional formatting
  • Macros
  • Tables
  • Shapes
  • Sparklines
  • Hyperlinks
  • Rich string formats
  • Defined names
  • Grouping/Outlines
  • Cell comments
  • Panes
  • Page set-up and printing options

write_xlsx uses the same interface as writeexcel gem.


Add this line to your application's Gemfile:

gem 'write_xlsx'

And then execute:

$ bundle

Or install it yourself as:

$ gem install write_xlsx


To write a string, a formatted string, a number and a formula to the first worksheet in an Excel XML spreadsheet called ruby.xlsx:

require 'rubygems'
require 'write_xlsx'

# Create a new Excel workbook
workbook = WriteXLSX.new('ruby.xlsx')

# Add a worksheet
worksheet = workbook.add_worksheet

# Add and define a format
format = workbook.add_format # Add a format

# Write a formatted and unformatted string, row and column notation.
col = row = 0
worksheet.write(row, col, "Hi Excel!", format)
worksheet.write(1,   col, "Hi Excel!")

# Write a number and a formula using A1 notation
worksheet.write('A3', 1.2345)
worksheet.write('A4', '=SIN(PI()/4)')



Original Perl module was written by John McNamara(jmcnamara@cpan.org).

Converted to ruby by Hideo NAKAMURA(cxn03651@msj.biglobe.ne.jp) Copyright (c) 2012-2017 Hideo NAKAMURA.

See LICENSE.txt for further details.

Contributing to write_xlsx

  • repsitory: http://github.com/cxn03651/write_xlsx
  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
  • Fork the project
  • Start a feature/bugfix branch
  • Commit and push until you are happy with your contribution
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.