Как проверить международный идентификационный номер ценных бумаг (ISIN)
Если я не ошибаюсь, ISIN numbers последняя позиция является контрольной цифрой. Какова математическая функция, которая определяет ее значение в функции первых 11 цифр?
6 ответов
http://en.wikipedia.org/wiki/International_Securities_Identification_Number
процедура вычисления контрольных цифр ISIN аналогична методу "модуль 10 Double Add Double", используемому в CUSIPs. Чтобы вычислить контрольную цифру, сначала преобразуйте любые буквы в числа, добавив их порядковое положение в алфавите к 9, так что A = 10 и M = 22. Начиная с самой правой цифры, каждая цифра умножается на два. (Для проверки CUSIP цифр, эти два шага вспять.) Складывается результирующая строка цифр (числа больше 9 становятся двумя отдельными цифрами). Вычтите эту сумму из наименьшего числа, заканчивающегося нулем, который больше или равен ему: это дает контрольную цифру, которая также известна как дополнение десяти к сумме по модулю 10. То есть полученная сумма, включая контрольную цифру, кратна 10.
у них хороший пример тоже.
основываясь на примерах других, вот реализация C#, которая будет проверять как ISINs, так и CUSIPs (и, возможно, некоторые другие варианты Luhn).
использование:
foreach (var isin in ValidIsins)
{
var calculatedChecksum = SecuritiesValidation.CalculateChecksum(isin.Substring(0, 11));
var actualChecksum = (isin.Last() - '0');
Assert.AreEqual(calculatedChecksum, actualChecksum);
}
foreach (var cusip in ValidCusips)
{
var calculatedChecksum = SecuritiesValidation.CalculateChecksum(cusip.Substring(0, 8), true, true);
var actualChecksum = (cusip.Last() - '0');
Assert.AreEqual(calculatedChecksum, actualChecksum);
}
реализация:
public static class SecuritiesValidation
{
public static int CalculateChecksum(IEnumerable<char> codeWithoutChecksum, bool reverseLuhn = false, bool allowSymbols = false)
{
return reverseLuhn
? codeWithoutChecksum
.Select((c, i) => c.OrdinalPosition(allowSymbols).ConditionalMultiplyByTwo(i.IsOdd()).SumDigits())
.Sum()
.TensComplement()
: codeWithoutChecksum
.ToArray()
.ToDigits(allowSymbols)
.Select((d, i) => d.ConditionalMultiplyByTwo(i.IsEven()).SumDigits())
.Sum()
.TensComplement();
}
public static bool IsChecksumCorrect(string code, bool reverseLuhn = false, bool allowSymbols = false)
{
try
{
var checksum = code.Last().ToInt();
return checksum == CalculateChecksum(code.Take(code.Length - 1), reverseLuhn, allowSymbols);
}
catch
{
return false;
}
}
/* Be careful here. This method is probably inapropriate for anything other than its designed purpose of Luhn-algorithm based validation.
* Specifically:
* - numbers are assigned a value equal to the number ('0' == 0, '1' == 1).
* - letters are assigned a value indicating the number 9 plus the letters ordinal position in the English alphabet ('A' == 10, 'B' == 11).
* - if symbols are allowed (eg: for CUSIP validation), they are assigned values beginning from 36 ('*' == 36, '@' == 37).
*/
private static int OrdinalPosition(this char c, bool allowSymbols = false)
{
if (char.IsLower(c))
return char.ToUpper(c) - 'A' + 10;
if (char.IsUpper(c))
return c - 'A' + 10;
if (char.IsDigit(c))
return c.ToInt();
if (allowSymbols)
switch (c)
{
case '*':
return 36;
case '@':
return 37;
case '#':
return 38;
}
throw new ArgumentOutOfRangeException("Specified character is not a letter, digit or allowed symbol.");
}
private static bool IsEven(this int x)
{
return (x % 2 == 0);
}
private static bool IsOdd(this int x)
{
return !IsEven(x);
}
private static int ToInt(this char digit)
{
if (char.IsDigit(digit))
return digit - '0';
throw new ArgumentOutOfRangeException("Specified character is not a digit.");
}
private static IEnumerable<int> ToDigits(this char[] s, bool allowSymbols = false)
{
var digits = new List<int>();
for (var i = s.Length - 1; i >= 0; i--)
{
var ordinalPosition = s[i].OrdinalPosition(allowSymbols);
digits.Add(ordinalPosition % 10);
if (ordinalPosition > 9)
digits.Add(ordinalPosition / 10);
}
return digits;
}
private static int SumDigits(this int value)
{
//return value > 9 ? ((value / 10) + (value % 10)) : value;
return ((value / 10) + (value % 10));
}
private static int ConditionalMultiplyByTwo(this int value, bool condition)
{
return condition ? value * 2 : value;
}
private static int TensComplement(this int value)
{
return (10 - (value % 10)) % 10;
}
}
вероятно, имеет смысл использовать проверку контрольной суммы в сочетании с совпадением шаблона регулярного выражения. Это регулярное выражение, которое я использую:
ISIN код: ^(XS|AD|AE|AF|AG|AI|AL|AM|AO|AQ|AR|AS|AT|AU|AW|AX|AZ|BA|BB|BD|BE|BF|BG|BH|BI|BJ|BL|BM|BN|BO|BQ|BR|BS|BT|BV|BW|BY|BZ|CA|CC|CD|CF|CG|CH|CI|CK|CL|CM|CN|CO|CR|CU|CV|CW|CX|CY|CZ|DE|DJ|DK|DM|DO|DZ|EC|EE|EG|EH|ER|ES|ET|FI|FJ|FK|FM|FO|FR|GA|GB|GD|GE|GF|GG|GH|GI|GL|GM|GN|GP|GQ|GR|GS|GT|GU|GW|GY|HK|HM|HN|HR|HT|HU|ID|IE|IL|IM|IN|IO|IQ|IR|IS|IT|JE|JM|JO|JP|KE|KG|KH|KI|KM|KN|KP|KR|KW|KY|KZ|LA|LB|LC|LI|LK|LR|LS|LT|LU|LV|LY|MA|MC|MD|ME|MF|MG|MH|MK|ML|MM|MN|MO|MP|MQ|MR|MS|MT|MU|MV|MW|MX|MY|MZ|NA|NC|NE|NF|NG|NI|NL|NO|NP|NR|NU|NZ|OM|PA|PE|PF|PG|PH|PK|PL|PM|PN|PR|PS|PT|PW|PY|QA|RE|RO|RS|RU|RW|SA|SB|SC|SD|SE|SG|SH|SI|SJ|SK|SL|SM|SN|SO|SR|SS|ST|SV|SX|SY|SZ|TC|TD|TF|TG|TH|TJ|TK|TL|TM|TN|TO|TR|TT|TV|TW|TZ|UA|UG|UM|US|UY|UZ|VA|VC|VE|VG|VI|VN|VU|WF|WS|YE|YT|ZA|ZM|ZW)([0-9A-Z]{9})([0-9]{1})$
CUSIP: ^[A-Z0-9]{8}[0-9]$
на основе примеров, опубликованных в Википедии, метод:
- замените каждую букву ее порядковым номером (A=1, B=2 и так далее) плюс 9 ->
- для каждой цифры в позиции, начиная с самой правой позиции (
), замените его цифрами своего двойника (две цифры в двух векторных записях) ->
; - код подтверждения:
возможная реализация в JavaScript есть:
function getVerificationCode(isin)
{
if(isin.length != 12) return null;
var v = [];
for(var i = isin.length-2; i >= 0; i--)
{
var c = isin.charAt(i);
if(isNaN(c)) //Not a digit
{
var letterCode = isin.charCodeAt(i)-55; //Char ordinal + 9
v.push(letterCode % 10);
if(letterCode > 9)
v.push(Math.floor(letterCode/10));
}
else
v.push(Number(c));
}
var sum = 0;
var l = v.length;
for(var i = 0; i < l; i++)
if(i % 2 == 0)
{
var d = v[i]*2;
sum += Math.floor(d/10);
sum += d % 10;
}
else
sum += v[i];
return 10 - (sum % 10);
}
EDIT: чтобы включить обновления @queso:
function getVerificationCode(isin) {
if (isin.length != 12) return false;
var v = [];
for (var i = isin.length - 2; i >= 0; i--) {
var c = isin.charAt(i);
if (isNaN(c)) { //not a digit
var letterCode = isin.charCodeAt(i) - 55; //Char ordinal + 9
v.push(letterCode % 10);
if (letterCode > 9) {
v.push(Math.floor(letterCode / 10));
}
} else {
v.push(Number(c));
}
}
var sum = 0;
var l = v.length;
for (var i = 0; i < l; i++) {
if (i % 2 == 0) {
var d = v[i] * 2;
sum += Math.floor(d / 10);
sum += d % 10;
} else {
sum += v[i];
}
}
return (10 - (sum % 10)) % 10
}
я делюсь с вами функцией в Matlab, благодаря @pablo и @queso.
function isISIN = checkISINCode(Isin)
%
%
%
% see:
% - source:https://en.wikipedia.org/wiki/International_Securities_Identification_Number
% - source: https://stackoverflow.com/questions/16140753/how-to-validate-a-international-securities-identification-number-isin-number
%
%
isISIN = 0;
if length(Isin) ~= 12
return;
end
v = [];
for i = (length(Isin)-1):-1:1
c = Isin(i);
if isnan(str2double(Isin(i)))
% from ASCII
letterCode = double(upper(Isin(i))) - 64 + 9;
v = [mod(letterCode, 10), v];
if letterCode > 9
v = [floor(letterCode/10),v];
end
else
v = [int8(str2double(Isin(i))), v];
end
end
sum_ = 0;
l = length(v);
for i=1:l
if(mod(i-1,2) == 0)
d = v(i) * 2.;
sum_ = sum_ + floor( double(d) / 10.0);
sum_ = sum_ + mod(d, 10);
else
sum_ = sum_ + v(i);
end
end
checkValue = mod((10 - mod(sum_, 10)),10);
% Check Computed value with last digit
isISIN = int8(str2double(Isin(end))) == checkValue;
end
Я хотел бы поделиться своей реализацией в R. Это не требует какого-либо конкретного пакета.
mgsub-это функция поддержки, которая позволяет заменить все символы в коде ISIN одной командой. Он скопирован из заменить несколько букв с акцентами на gsub
на iso3166alpha2$Code содержит список стран, которые граната перечислил
алгоритм реализован в
<?php
function cusipToIsin($CUSIP, $Country)
{
if (strlen($CUSIP) == 9) {
$string = charToCusipBinary($Country) . charToCusipBinary($CUSIP); //Convert any letters to numbers
$arrayString = str_split($string);
//check wether string length is even or odd
if (strlen($string) % 2 != 0) {
$num = 0;
foreach ($arrayString as $key => $value) {
//Collect odd and even characters
if ($key % 2 != 0) {
$values = $value;
} else {
$values = $value * 2; //The key is in odd position, so Multiply by 2
}
$sumValue = array_sum(str_split($values)); //Add up the individual digits
$num += $sumValue;
}
$isinCheckDigit = (10 - ($num % 10)) % 10;
$result1 = strtoupper($Country . $CUSIP . $isinCheckDigit);
} else {
$num = 0;
foreach ($arrayString as $key => $value) {
//Collect odd and even characters
if ($key % 2 != 0) {
$values = $value * 2; //The key is in even position, so Multiply by 2
} else {
$values = $value;
}
$sumValue = array_sum(str_split($values)); //Add up the individual digits
$num += $sumValue;
}
$isinCheckDigit = (10 - ($num % 10)) % 10;
$result1 = strtoupper($Country . $CUSIP . $isinCheckDigit);
}
$Validate = isinValidate($result1);
if ($Validate == true) {
$result = $result1;
} else {
$result = 'Please check the CUSIP';
}
} else {
$result = 'Please check the CUSIP';
}
return $result;
}
function charToCusipBinary($string)
{
return strtr(strtoupper($string), ['A' => '10', 'B' => '11', 'C' => '12', 'D' => '13', 'E' => '14', 'F' => '15', 'G' => '16', 'H' => '17', 'I' => '18', 'J' => '19', 'K' => '20', 'L' => '21', 'M' => '22', 'N' => '23', 'O' => '24', 'P' => '25', 'Q' => '26', 'R' => '27', 'S' => '28', 'T' => '29', 'U' => '30', 'V' => '31', 'W' => '32', 'X' => '33', 'Y' => '34', 'Z' => '35']);
}
function isinValidate($isin)
{
if (!preg_match('/^[A-Z]{2}[A-Z0-9]{9}[0-9]$/i', $isin)) {
return false;
}
$base10 = '';
for ($i = 0; $i <= 11; $i++) {
$base10 .= base_convert($isin{$i}, 36, 10);
}
$checksum = 0;
$len = strlen($base10) - 1;
$parity = $len % 2;
for ($i = $len; $i >= 0; $i--) {
$weighted = $base10{$i} << (($i - $parity) & 1);
$checksum += $weighted % 10 + (int) ($weighted / 10);
}
return !(bool) ($checksum % 10);
}
echo cusipToIsin('78012KD61', 'US'); //ISIN: US78012KD617
?>