Currency Examples

(Difference between revisions)

Jump to: navigation, search
m (Historic prices: Fix typo)
Current revision (04:58, 7 April 2013) (view source)
m (Reverted edits by ABIDEEN10 (Talk) to last version by Tantek)
 
(17 intermediate revisions not shown.)
Line 1: Line 1:
-
= Currency Examples =
+
<entry-title> Currency Examples </entry-title>
-
The following are real-world examples and brainstorming for marking up '''[[currency]]'''.
+
The following are real-world [[examples]] of pages that have amounts of money that could be marked up with a '''[[currency]]''' microformat. As part of the microformats process:
 +
* [[currency-examples]]
 +
* [[currency-formats]]
 +
* [[currency-brainstorming]]
-
==The Problem==
+
== Real-World Examples ==
 +
''Links to public web pages, either popular or insightful''
-
The problem: how to explicitly specify a) that a figure/number relates to money; b) the currency of a stated figure; and c) the period in which that figure was current.
+
===Google Financials===
-
 
+
Use of currency amounts in tables.
-
*The currency sign cannot be used reliably since the same sign (or symbol) may represent more than one currency. eg. $ is used for many different dollars (USD, AUD, CAD...) and even [http://en.wikipedia.org/wiki/Currency_sign#Examples other units like pesos].
+
-
*The language of the page is not sufficient to define the currency of prices in the page:
+
-
**More than one currency may be used by people who speak the same language.
+
-
**The page may be written in one language and still quote prices/figures in a different country's currency.
+
-
**Even if a country can be identified, more than one currency may be used in that country.
+
-
 
+
-
Converting currency figures is a reasonably easy problem to solve as indicated by the [[#Existing_Practices]]. However many automated conversion tools must make assumptions about the original figure's currency -- e.g. assuming a USD for all uses of $, or British Pounds for £ (which is also [http://en.wikipedia.org/wiki/Lira sometimes used to denote Lira]).
+
-
 
+
-
=== Currency Changes ===
+
-
I wish to expand on one of the points mentioned above: there might be two or more currencies in the same country: e.g. in Romania
+
-
* ROL - Romanian Lei [being phased out]
+
-
* RON - Romanian New Lei
+
-
* after Romania joins the EU, the RON will be replaced by Euro, too (not imediately, probably in 2-3 years)
+
-
 
+
-
Although the three letter code is different in this case, the currency is often given as ''Lei''. There are other countries, where similar examples exist/existed. The two currencies might have an identical name, yet they have 2 very different meanings. Usually there is a difference of 3-4 orders of magnitude between the old currency and the new currency.
+
-
[[discoleo]]
+
-
 
+
-
 
+
-
===Related problems===
+
-
<p>"Amounts" in arbitrary units is a bit harder and necessary for several applications.</p>
+
-
 
+
-
<p>For example, consider the work that has been done on a recipe microformat.</p>
+
-
 
+
-
[[recipe-examples]]
+
-
 
+
-
<p>Though we haven't reached this problem yet in the research, I can see it
+
-
coming:</p>
+
-
 
+
-
<p>Say you wanted to create a "shopping list" application which you could tell which recipes you wanted to cook, and have it automatically total up all the various amounts of ingredients and give you the net amount of stuff you wanted to pick up.</p>
+
-
 
+
-
<p>It would need to be able to determine precise amounts/units of each ingredient.  This might turn out to be like the currency problem, or it might be more complex, given the variety of units used in recipes, English vs. metric etc.  That's a case that might need a microformat.  We need more research and analysis to really justify it, but I can see it within the realm of probable possibility.</p>
+
-
 
+
-
===Use of currency amounts in tables===
+
Representing currency amounts in a table format is very common. For instance, see [http://investor.google.com/fin_data.html Google Financials].
Representing currency amounts in a table format is very common. For instance, see [http://investor.google.com/fin_data.html Google Financials].
Line 47: Line 18:
The currency symbol/abbreviation should be optional in for elements defined as containing currency values/amounts, if a default currency has been defined in one of the ancestor elements.
The currency symbol/abbreviation should be optional in for elements defined as containing currency values/amounts, if a default currency has been defined in one of the ancestor elements.
-
==Contributors==
+
=== UK Government Data Standards Catalogue ===
-
* [http://weblog.200ok.com.au/ Ben Buchanan] (proponent)
+
-
* Arve Bersvendsen
+
-
* [http://tantek.com/log/ Tantek Çelik]
+
-
* [http://steve.ganz.name/ Steve Ganz]
+
-
* Charles Iliya Krempeaux
+
-
*[[User:AndyMabbett|Andy Mabbett]] (2nd proponent)
+
-
* Ciaran McNulty
+
-
* Mike Stickel
+
-
* Ben Ward
+
-
* Guillaume Lebleu
+
-
== Real-World Examples ==
+
[http://www.govtalk.gov.uk/gdsc/html/frames/AmountSterling-1-0-Release.htm UK Government Data Standards Catalogue]
-
''Links to public web pages, either popular or insightful''
+
-
=== [http://www.govtalk.gov.uk/gdsc/html/frames/AmountSterling-1-0-Release.htm UK Government Data Standards Catalogue] ===
 
-
 
The [http://www.govtalk.gov.uk/gdsc/schemaHtml/FinancialTypes-v1-1-xsd-AmountSterlingStructure.htm associated XML Schema] seems to suggest an ''Amount'' element, followed by a fixed ''Currency'' element of "GBP".
The [http://www.govtalk.gov.uk/gdsc/schemaHtml/FinancialTypes-v1-1-xsd-AmountSterlingStructure.htm associated XML Schema] seems to suggest an ''Amount'' element, followed by a fixed ''Currency'' element of "GBP".
-
=== [http://www.skype.com/products/skypeout/ SkypeOut Pricing] ===
+
=== SkypeOut Pricing ===
 +
[http://www.skype.com/products/skypeout/ SkypeOut Pricing].
<pre>2.1 US cents/2.4 CAN cents per minute</pre> (on the Web page)
<pre>2.1 US cents/2.4 CAN cents per minute</pre> (on the Web page)
Line 74: Line 33:
See also [[measure]]
See also [[measure]]
-
=== [http://enterpriseforum.mit.edu/mindshare/startingup/dilution.html MIT Enterprise Forum ] ===
+
=== MIT Enterprise Forum ===
 +
[http://enterpriseforum.mit.edu/mindshare/startingup/dilution.html MIT Enterprise Forum ].
<pre>$1 million in equity</pre>
<pre>$1 million in equity</pre>
Line 82: Line 42:
See also [[measure]]
See also [[measure]]
-
=== [http://tonto.eia.doe.gov/oog/info/ngw/historical/2004/06_24/ngupdate.asp Energy Information Administration] ===
+
=== Energy Information Administration ===
 +
[http://tonto.eia.doe.gov/oog/info/ngw/historical/2004/06_24/ngupdate.asp Energy Information Administration].
<pre>23 cents per barrel</pre>
<pre>23 cents per barrel</pre>
Line 96: Line 57:
See also [[measure]]
See also [[measure]]
-
=== [http://www.cbc.ca/money/story/2005/08/08/oil-050808.html CBCNews] ===
+
=== CBCNews ===
 +
[http://www.cbc.ca/money/story/2005/08/08/oil-050808.html CBCNews].
<pre>$63.94 US per barrel, up $1.63 US</pre>
<pre>$63.94 US per barrel, up $1.63 US</pre>
-
=== [http://finance.google.com/finance?q=google&hl=en Google Finance] ===
+
=== Google Finance ===
 +
[http://finance.google.com/finance?q=google&hl=en Google Finance].
The current price of a stock:
The current price of a stock:
Line 106: Line 69:
<pre><span class="pr">401.90</span></pre>
<pre><span class="pr">401.90</span></pre>
-
=== [http://www.ebay.com eBay] ===
+
=== eBay ===
 +
[http://www.ebay.com eBay].
eBay marks prices as "ebcPr". eBay c? Price.
eBay marks prices as "ebcPr". eBay c? Price.
Line 114: Line 78:
</pre>
</pre>
-
=== [http://code.google.com/webstats/2005-12/classes.html Google] ===
+
=== Google Web Authoring Statistics ===
 +
[http://code.google.com/webstats/2005-12/classes.html Google Web Authoring Statistics] - indirect example.
The Google Web Authoring Statistics mentions that "price" is the 40th most used class name.
The Google Web Authoring Statistics mentions that "price" is the 40th most used class name.
Line 124: Line 89:
</pre>
</pre>
-
=== [http://us.mcafee.com/root/package.asp?pkgid=100 McAfee] ===
+
=== McAfee ===
 +
[http://us.mcafee.com/root/package.asp?pkgid=100 McAfee].
 +
 
<pre>
<pre>
<span class="price">$39.99 <span class="currency">(USD)</span></span>
<span class="price">$39.99 <span class="currency">(USD)</span></span>
</pre>
</pre>
-
=== [http://www.amazon.com/gp/product/0764597582/sr=8-9/qid=1153301402/ref=sr_1_9/002-9103678-0608852?ie=UTF8 Amazon] ===
+
=== Amazon Product listing ===
 +
[http://www.amazon.com/gp/product/0764597582 Amazon Product listing].
<pre><td class="price">$34.85</td></pre>
<pre><td class="price">$34.85</td></pre>
-
=== [https://secure.vmp.com/signup/adv_signup.php?locale=fr_CA Bell Canada in French Canadian] ===
+
=== Bell Canada in French Canadian ===
 +
[https://secure.vmp.com/signup/adv_signup.php?locale=fr_CA Bell Canada in French Canadian].
<pre><b>Niveau de service Premium - 125 $*</b></pre>
<pre><b>Niveau de service Premium - 125 $*</b></pre>
Line 139: Line 108:
Note the placement of the dollar sign AFTER the number.
Note the placement of the dollar sign AFTER the number.
-
=== [https://secure.vmp.com/signup/adv_signup.php?locale=en_US Bell Canada in US English] ===
+
=== Bell Canada in US English ===
 +
[https://secure.vmp.com/signup/adv_signup.php?locale=en_US Bell Canada in US English].
<pre><b>Premium Service Level - $125*</b></pre>
<pre><b>Premium Service Level - $125*</b></pre>
Line 167: Line 137:
== Existing Practices ==
== Existing Practices ==
 +
* ... ?
===Firefox Extension===
===Firefox Extension===
Line 185: Line 156:
[http://6v8.gamboni.org/Greasemonkey-Yahoo-Finance.html Yahoo! Finance Currency Converter]
[http://6v8.gamboni.org/Greasemonkey-Yahoo-Finance.html Yahoo! Finance Currency Converter]
-
 
-
===Relevant Standards ===
 
-
[http://www.xe.com/iso4217.htm ISO 4217 Codes]
 
-
 
-
 
==See also==
==See also==

Current revision

The following are real-world examples of pages that have amounts of money that could be marked up with a currency microformat. As part of the microformats process:

Contents

Real-World Examples

Links to public web pages, either popular or insightful

Google Financials

Use of currency amounts in tables.

Representing currency amounts in a table format is very common. For instance, see Google Financials.

In this table representation, it does not make sense to provide the currency information for each cell. Instead, it should be provided once at the table, thead, tr, or th, level, and then a td may override the default value. This is very similar to the common practice of indicating the currency and formatting in plain english: "Numbers in thousands of dollars" in the table title/subtitle or legend.

The microformat for currency amounts should provide a way to represent a default currency for all children of a table, thead, tr, or th nodes. The currency symbol/abbreviation should be optional in for elements defined as containing currency values/amounts, if a default currency has been defined in one of the ancestor elements.

UK Government Data Standards Catalogue

UK Government Data Standards Catalogue

The associated XML Schema seems to suggest an Amount element, followed by a fixed Currency element of "GBP".

SkypeOut Pricing

SkypeOut Pricing.

2.1 US cents/2.4 CAN cents per minute
(on the Web page)
¢2.1 USD (or ¢2.4 CAD) per minute.
(in the announcement email)

See also measure

MIT Enterprise Forum

MIT Enterprise Forum .

$1 million in equity
$2.50 a share

See also measure

Energy Information Administration

Energy Information Administration.

23 cents per barrel

Also in this page:

(U.S. Cents per Gallon)
(Euros per Thousand Liters)
(U.S. Dollars per Gallon)

See also measure

CBCNews

CBCNews.

$63.94 US per barrel, up $1.63 US

Google Finance

Google Finance.

The current price of a stock:

<span class="pr">401.90</span>

eBay

eBay.

eBay marks prices as "ebcPr". eBay c? Price.

<td class="ebcPr"><span class="bold">$11.70</span><br/><span>$12.95</span><br/></td>

Google Web Authoring Statistics

Google Web Authoring Statistics - indirect example.

The Google Web Authoring Statistics mentions that "price" is the 40th most used class name.

Something like:

<span class="price">$39.99</span>

McAfee

McAfee.

<span class="price">$39.99 <span class="currency">(USD)</span></span>

Amazon Product listing

Amazon Product listing.

<td class="price">$34.85</td>

Bell Canada in French Canadian

Bell Canada in French Canadian.

<b>Niveau de service Premium - 125 $*</b>

Note the placement of the dollar sign AFTER the number.

Bell Canada in US English

Bell Canada in US English.

<b>Premium Service Level - $125*</b>

Historic prices

Existing Practices

Firefox Extension

Firefox Currency Converter - ViewMyCurrency

Note: the current bug list illustrates some problems of identifying currencies based on page content alone:

  • All $ symbols are treated as USD Very annoying if you are Australian, Canadian etc. (Needs a new feature)
  • ‘Euro 2006 Championship’ should not be converted.
  • ...
  • Don’t convert CVS keywords . $Revision: 1.3 $ should not be treated as dollars.

Greasemonkey Scripts

Exchequer

Yahoo! Finance Currency Converter

See also

Related pages

Currency Examples was last modified: Sunday, April 7th, 2013

Views