code: public long set(long instant, String text, Locale locale) {
          int value = convertText(text, locale);
          return set(instant, value);
      }
docs: Sets a value in the milliseconds supplied from a human-readable, text value.
  If the specified locale is null, the default locale is used.
  <p>
  This implementation uses <code>convertText(String, Locale)</code> and
  {@link #set(long, int)}.
  <p>
  Note: subclasses that override this method should also override
  getAsText.
  
  @param instant  the milliseconds from 1970-01-01T00:00:00Z to set in
  @param text  the text value to set
  @param locale the locale to use for selecting a text symbol, null for default
  @return the updated milliseconds
  @throws IllegalArgumentException if the text value is invalid