Class: Creek::Styles::StyleTypes

Inherits:
Object
  • Object
show all
Includes:
Constants
Defined in:
lib/creek/styles/style_types.rb

Constant Summary

Constants included from Constants

Constants::NumFmtMap

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(styles_xml_doc) ⇒ StyleTypes

Returns a new instance of StyleTypes.



10
11
12
 
# File 'lib/creek/styles/style_types.rb', line 10

def initialize(styles_xml_doc)
  @styles_xml_doc = styles_xml_doc
end

Instance Attribute Details

#styles_xml_doc ⇒ Object

Returns the value of attribute styles_xml_doc.



9
10
11
 
# File 'lib/creek/styles/style_types.rb', line 9

def styles_xml_doc
  @styles_xml_doc
end

Instance Method Details

#call ⇒ Object

Excel doesn’t record types for some cells, only its display style, so we have to back out the type from that style.

Some of these styles can be determined from a known set (see NumFmtMap), while others are ‘custom’ and we have to make a best guess.

This is the array of types corresponding to the styles a spreadsheet uses, and includes both the known style types and the custom styles.

Note that the xml sheet cells that use this don’t reference the numFmtId, but instead the array index of a style in the stored list of only the styles used in the spreadsheet (which can be either known or custom). Hence this style types array, rather than a map of numFmtId to type.



28
29
30
31
32
33
34
35
 
# File 'lib/creek/styles/style_types.rb', line 28

def call
  @style_types ||= begin
    styles_xml_doc.css('styleSheet cellXfs xf').map do |xstyle|
      a = num_fmt_id(xstyle)
      style_type_by_num_fmt_id( a )
    end
  end
end

#custom_style_types ⇒ Object

Map of (numFmtId >= 164) (custom styles) to our best guess at the type ex. => :date_time



59
60
61
62
63
64
65
66
67
68
 
# File 'lib/creek/styles/style_types.rb', line 59

def custom_style_types
  @custom_style_types ||= begin
    styles_xml_doc.css('styleSheet numFmts numFmt').inject({}) do |acc, xstyle|
      index      = xstyle.attributes['numFmtId'].value.to_i
      value      = xstyle.attributes['formatCode'].value
      acc[index] = determine_custom_style_type(value)
      acc
    end
  end
end

#determine_custom_style_type(string) ⇒ Object

This is the least deterministic part of reading xlsx files. Due to custom styles, you can’t know for sure when a date is a date other than looking at its format and gessing. It’s not impossible to guess right, though.

stackoverflow.com/questions/4948998/determining-if-an-xlsx-cell-is-date-formatted-for-excel-2007-spreadsheets



76
77
78
79
80
81
82
83
84
 
# File 'lib/creek/styles/style_types.rb', line 76

def determine_custom_style_type(string)
  return :float if string[0] == '_'
  return :float if string[0] == ' 0'

  # Looks for one of ymdhis outside of meta-stuff like [Red]
  return :date_time if string =~ /(^|\])[^\[]*[ymdhis]/i

  return :unsupported
end

#num_fmt_id(xstyle) ⇒ Object

returns the numFmtId value if it’s available



38
39
40
41
 
# File 'lib/creek/styles/style_types.rb', line 38

def num_fmt_id(xstyle)
  return nil unless xstyle.attributes['numFmtId']
  xstyle.attributes['numFmtId'].value
end

#style_type_by_num_fmt_id(id) ⇒ Object

Finds the type we think a style is; For example, fmtId 14 is a date style, so this would return :date.

Note, custom styles usually (are supposed to?) have a numFmtId >= 164, but in practice can sometimes be simply out of the usual “Any Language” id range that goes up to 49. For example, I have seen a numFmtId of 59 specified as a date. In Thai, 59 is a number format, so this seems like a bad idea, but we try to be flexible and just go with it.



51
52
53
54
55
 
# File 'lib/creek/styles/style_types.rb', line 51

def style_type_by_num_fmt_id(id)
  return nil unless id
  id = id.to_i
  NumFmtMap[id] || custom_style_types[id]
end