Class: Stupidedi::Versions::FunctionalGroups::FortyTen::ElementTypes::DateVal::Improper

Inherits:
Stupidedi::Versions::FunctionalGroups::FortyTen::ElementTypes::DateVal show all
Defined in:
lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb

Overview

Date with a partially-specified year (two digits, missing century). Shouldn't be directly instantiated -- instead, use the constuctor method value

Instance Attribute Summary (collapse)

Attributes inherited from Stupidedi::Values::SimpleElementVal

#position, #usage

Instance Method Summary (collapse)

Methods inherited from Stupidedi::Versions::FunctionalGroups::FortyTen::ElementTypes::DateVal

#date?, empty, parse, #too_long?, #too_short?, value

Methods inherited from Stupidedi::Values::SimpleElementVal

#allowed?, #component?, #date?, #definition, #id?, #leaf?, #numeric?, #simple?, #string?, #time?, #to_x12

Methods inherited from Stupidedi::Values::AbstractElementVal

#element?, #size

Methods inherited from Stupidedi::Values::AbstractVal

#blank?, #characters, #component?, #composite?, #definition, #element?, #functional_group?, #interchange?, #invalid?, #loop?, #present?, #repeated?, #segment?, #separator?, #simple?, #size, #table?, #transaction_set?, #transmission?

Methods included from Color

ansi, #ansi

Constructor Details

- (Improper) initialize(year, month, day, usage, position)

A new instance of Improper



293
294
295
296
297
298
299
300
301
302
303
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 293

def initialize(year, month, day, usage, position)
  @year, @month, @day = year, month, day

  # Check that date is reasonably valid
  unless @year.between?(0, 99) and @month.between?(1, 12) and @day.between?(1, 31)
    raise Exceptions::InvalidElementError,
      "invalid date year: #{year}, month: #{month}, day: #{day}"
  end

  super(usage, position)
end

Instance Attribute Details

- (Integer) day (readonly)

Returns:



291
292
293
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 291

def day
  @day
end

- (Integer) month (readonly)

Returns:



288
289
290
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 288

def month
  @month
end

- (Integer) year (readonly)

Returns:



285
286
287
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 285

def year
  @year
end

Instance Method Details

- (Boolean) ==(other)

Note:

Not commutative

Returns:

  • (Boolean) 


438
439
440
441
442
443
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 438

def ==(other)
  eql?(other) or
   (@day   == other.day  and
    @year  == other.year and
    @month == other.month)
end

- (Proper) century(cc)

Create a proper date using the given century cc

Examples:

DateVal.value("501015").century(19) #=> DateVal.value("19501230")

Returns:



333
334
335
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 333

def century(cc)
  Proper.new(100 * cc + @year, @month, @day, usage, position)
end

- (Improper) copy(changes = {})

Returns:



306
307
308
309
310
311
312
313
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 306

def copy(changes = {})
  Improper.new \
    changes.fetch(:year, @year),
    changes.fetch(:month, @month),
    changes.fetch(:day, @day),
    changes.fetch(:usage, usage),
    changes.fetch(:position, position)
end

- (Boolean) empty?

Returns:

  • (Boolean) 


319
320
321
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 319

def empty?
  false
end

- (Proper) future

Create a proper date which cannot be older than the current date

Returns:



410
411
412
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 410

def future
  oldest(Date.today)
end

- (String) inspect

Returns:



415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 415

def inspect
  id = definition.bind do |d|
    "[#{'% 5s' % d.id}: #{d.name}]".bind do |s|
      if usage.forbidden?
        ansi.forbidden(s)
      elsif usage.required?
        ansi.required(s)
      else
        ansi.optional(s)
      end
    end
  end

  ansi.element("DT.value#{id}") << "(XX#{'%02d-%02d-%02d' % [@year, @month, @day]})"
end

- (Proper) newest(date)

Create a proper date which cannot be newer than the given date and cannot be older than one year before the given date.

Examples:

DateVal.value("501015").newest(Date.civil(1950, 10, 20)) #=> DateVal.value("19501015")
DateVal.value("501015").newest(Date.civil(1950, 10, 15)) #=> DateVal.value("19501015")
DateVal.value("501015").newest(Date.civil(1950, 10, 10)) #=> DateVal.value("18501015")

Returns:



378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 378

def newest(date)
  cc, yy = date.year.divmod(100)

  if @year < yy
    century(cc)
  elsif @year > yy
    century(cc - 1)
  else
    if @month < date.month
      century(cc)
    elsif @month > date.month
      century(cc - 1)
    else
      if @day <= date.day
        century(cc)
      else
        century(cc - 1)
      end
    end
  end
end

- (Proper) oldest(date)

Create a proper date which cannot be older than the given date and cannot be newer than one year after the given date.

Examples:

DateVal.value("501015").oldest(Date.civil(1950, 10, 20)) #=> DateVal.value("20501015")
DateVal.value("501015").oldest(Date.civil(1950, 10, 15)) #=> DateVal.value("19501015")
DateVal.value("501015").oldest(Date.civil(1950, 10, 10)) #=> DateVal.value("19501015")

Returns:



346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 346

def oldest(date)
  cc, yy = date.year.divmod(100)

  if @year < yy
    century(cc + 1)
  elsif @year > yy
    century(cc)
  else
    if @month < date.month
      century(cc + 1)
    elsif @month > date.month
      century(cc)
    else
      if @day < date.day
        century(cc + 1)
      else
        century(cc)
      end
    end
  end

end

- (Proper) past

Create a proper date which cannot be newer than the current date

Returns:



403
404
405
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 403

def past
  newest(Date.today)
end

- (Boolean) proper?

Returns:

  • (Boolean) 


323
324
325
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 323

def proper?
  false
end

- (String) to_s

Returns:



432
433
434
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 432

def to_s
  '%04d%02d%02d' % [@year, @month, @day]
end

- (Boolean) valid?

Returns:

  • (Boolean) 


315
316
317
 
# File 'lib/stupidedi/versions/functional_groups/004010/element_types/date_val.rb', line 315

def valid?
  true
end